Quasuki SDK

Quasuki is the executable agent commerce layer. Shoonya is the proof layer.

This package is the public machine-client entrypoint for governed agent commerce.

Public naming rule:

• use Quasuki public task refs such as zones.list, admission.preview, policy.simulate, and settlement.submit
• treat deeper stack refs such as naxytra.*, xytadel.*, and openetram.* as advanced provenance/debug metadata

Versioned Quasuki machine-client SDK for:

• catalog discovery
• schema-aware task shaping
• multi-task validation and execution
• quote preview and quote creation
• governed transaction and receipt retrieval
• compact workflow summaries for agent consumption

Public product boundary:

• shoonya remains the trust, receipt, and evidence substrate
• quasuki-sdk is the paid execution, settlement, and governed delivery client layer

Canonical line:

Shoonya proves. Quasuki sells and executes.

Install

npm install quasuki-sdk

Node runtime target: >=18

Shortest Path

const { createClient } = require("quasuki-sdk");

const client = createClient({
  baseUrl: process.env.QUASUKI_BASE_URL,
  apiKey: process.env.QUASUKI_API_KEY,
  walletId: process.env.QUASUKI_WALLET_ID,
  walletSecret: process.env.QUASUKI_WALLET_SECRET,
  accountId: process.env.QUASUKI_ACCOUNT_ID
});

async function main() {
  const result = await client.execute({
    command: "List zones",
    task_ref: "zones.list",
    body: {}
  });

  console.log(client.summarizeCommandResult(result));
}

main().catch((error) => {
  console.error(error.message);
  process.exit(1);
});

Common Flows

Inspect Catalog Schema

const { createClient } = require("quasuki-sdk");

const client = createClient({ baseUrl: process.env.QUASUKI_BASE_URL });

async function main() {
  const summary = await client.fetchCatalogSummary();
  const categories = await client.listTaskCategories();
  const schema = await client.getTaskSchema("admission.preview");
  const template = await client.getTaskTemplate("admission.preview");

  console.log(summary);
  console.log(categories);
  console.log(schema);
  console.log(template);
}

main().catch(console.error);

Single Task Execute

const { createClient } = require("quasuki-sdk");

const client = createClient({
  baseUrl: process.env.QUASUKI_BASE_URL,
  apiKey: process.env.QUASUKI_API_KEY,
  walletId: process.env.QUASUKI_WALLET_ID,
  walletSecret: process.env.QUASUKI_WALLET_SECRET
});

async function main() {
  const result = await client.execute({
    command: "List zones",
    task_ref: "zones.list",
    body: {}
  });

  console.log(JSON.stringify(client.summarizeCommandResult(result), null, 2));
}

main().catch(console.error);

Multi-Task Execute

const { createClient } = require("quasuki-sdk");

const client = createClient({
  baseUrl: process.env.QUASUKI_BASE_URL,
  apiKey: process.env.QUASUKI_API_KEY,
  walletId: process.env.QUASUKI_WALLET_ID,
  walletSecret: process.env.QUASUKI_WALLET_SECRET
});

async function main() {
  const result = await client.executeTaskSet(
    [
      {
        task_id: "zones",
        task_ref: "zones.list",
        body: {}
      },
      {
        task_id: "preview",
        task_ref: "admission.preview",
        body: {
          source_zone_id: "<source-zone-id>",
          target_zone_id: "<target-zone-id>",
          interaction_class: "<interaction-class>",
          artifacts: {
            receipt_types: ["shoonya_receipt"]
          }
        }
      }
    ],
    {
      command: "Inspect zones and preview admission"
    }
  );

  console.log(JSON.stringify(client.summarizeCommandResult(result), null, 2));
}

main().catch(console.error);

Quote Preview

const { createClient } = require("quasuki-sdk");

const client = createClient({
  baseUrl: process.env.QUASUKI_BASE_URL,
  apiKey: process.env.QUASUKI_API_KEY
});

async function main() {
  const quote = await client.previewExecutionQuote({
    command: "List zones",
    task_ref: "zones.list",
    body: {}
  });

  console.log(JSON.stringify(client.summarizeQuote(quote), null, 2));
}

main().catch(console.error);

Runnable examples are in examples/:

• examples/single-task.js
• examples/multi-task.js
• examples/quote-preview.js
• examples/standalone-consumer/

Standalone Consumer Proof

If you want a clean external install proof instead of using the workspace repo:

cd examples/standalone-consumer
npm install
npm run catalog

That example depends on the published package version from npm, not a local file reference.

Public independent consumer proof:

• repo: https://github.com/quasuki/quasuki-sdk-first-live-run
• release: https://github.com/quasuki/quasuki-sdk-first-live-run/releases/tag/v0.1.0
• validated flow: live catalog fetch, self-serve agent onboarding, and paid zones.list execution through the published package

Narrow Public Launch Pricing

The current public Quasuki launch pricing surface is intentionally narrow.

Representative starting prices:

• billing.summary at $0.05
• admission.preview at $0.10
• policy.simulate at $0.35
• workflow.pack at $0.50
• jobs.commit at $1.25
• settlement.submit at $1.50
• trust.verify at $0.50
• receipt_ledger.handoff.validate at $0.60
• runtime.emit_anchor at $4.50

These are pricing-basis values for the first public tasks. Settlement rail choice can affect the final settlement amount.

Environment

Typical environment variables:

• QUASUKI_BASE_URL
• QUASUKI_API_KEY
• QUASUKI_WALLET_ID
• QUASUKI_WALLET_SECRET
• QUASUKI_ACCOUNT_ID

Required by flow:

• catalog/schema inspection: QUASUKI_BASE_URL
• native execute: QUASUKI_BASE_URL, QUASUKI_API_KEY, QUASUKI_WALLET_ID, QUASUKI_WALLET_SECRET
• x402 execute: QUASUKI_BASE_URL, QUASUKI_ACCOUNT_ID, QUASUKI_WALLET_ID, QUASUKI_WALLET_SECRET
• transaction/receipt retrieval: QUASUKI_BASE_URL, QUASUKI_API_KEY

Stable Public Surface

Stable entrypoints:

• require("quasuki-sdk")
• require("quasuki-sdk/client")

Current declared contract:

• QUASUKI_SDK_NAME = "quasuki-sdk"
• QUASUKI_SDK_VERSION = "0.2.5"
• QUASUKI_API_VERSION = "v1"
• createClient(options)
• QuasukiClient

Core client methods:

• fetchCatalog()
• fetchCatalogSummary()
• summarizeCatalog(payload)
• listTasks()
• listTaskCategories()
• getTask(taskRef)
• getTaskDetail(taskRef)
• summarizeTask(task)
• getTaskPricing(taskRef)
• getSettlementProfiles()
• getTaskSchema(taskRef)
• getTaskTemplate(taskRef)
• getTaskTemplates(taskRefs)
• validateTaskBody(taskRef, body)
• validateTaskSet(tasks)
• buildTaskSetPayload(taskSpecs, options)
• withSettlement(payload, options)
• previewExecutionQuote(payload, options)
• createPaymentQuote(payload)
• execute(payload, options)
• executeTaskSet(taskSpecs, options)
• getTransaction(transactionId)
• getReceipt(receiptId)
• waitForTransaction(transactionId, options)
• waitForMonitor(result, options)
• summarizeQuote(payload)
• summarizeTransaction(payload)
• summarizeReceipt(payload)
• summarizeCommandResult(payload)

Settlement/profile ergonomics:

• buildTaskSetPayload(..., { settlementMode }) now carries settlement_mode
• buildTaskSetPayload(..., { settlement }) now carries the explicit settlement proof object
• previewExecutionQuote(payload, { settlementMode }) now applies per-quote rail selection without mutating the original payload
• execute(payload, { settlementMode, settlement }) now applies the same settlement selection/proof convenience path

Catalog/pricing ergonomics:

• summarizeCatalog(payload) returns a compact view of catalog version, task count, settlement profiles, and task pricing hints
• fetchCatalogSummary() returns the compact server-side catalog view when available
• listTaskCategories() returns public categories for navigation without dumping the full catalog
• listTasks() returns compact task summaries including public aliases, category, pricing_band, public_launch_price, and pricing_note
• getTaskDetail(taskRef) resolves a public alias or internal task ref to the full catalog task detail
• getTaskPricing(taskRef) returns only the pricing-hint slice for a single task
• getSettlementProfiles() returns compact settlement-profile summaries for the active deployment

Repository And Release

Repository: https://github.com/quasuki/quasuki-sdk

Release checks:

• npm run verify:all
• npm run pack:dry-run
• npm run release:check
• npm run release:plan

Version bump helper:

• npm run version:bump -- patch
• npm run version:bump -- minor
• npm run version:bump -- major
• npm run version:bump -- 0.3.0

Related release docs:

• CHANGELOG.md
• SDK_COMPATIBILITY.md
• RELEASE.md