dero-mcp-server 0.1.2 → 0.4.0

package/dist/citations.js

@@ -0,0 +1,322 @@
+/**
+ * Citation helper for DERO MCP tool responses.
+ *
+ * The wedge for this server is the combination of live chain reads and the
+ * in-process bundled docs index (145+ pages across derod, tela, hologram,
+ * deropay). Citations let agents link their responses back to authoritative
+ * docs without a second tool call, and they give downstream composite tools
+ * a uniform shape to compose.
+ *
+ * Design contract:
+ *   - One shape, used by primitives and composites alike.
+ *   - URLs are produced by the same builder used by `dero_docs_*` so the
+ *     citation always points at the same canonical page the agent would
+ *     reach via dero_docs_get_page.
+ *   - The slug is duplicated as `page_id` to give composites a stable join
+ *     key across tools (mirrors the FoodNearMe COMPOSITES.md citation pattern).
+ *   - The map of related docs per tool is hand-maintained and validated by
+ *     `scripts/check-citations.ts` (added alongside this helper) so a docs
+ *     reorganization cannot silently produce 404 citations in production.
+ */
+import { DOC_BASE_URLS } from './docs-parse.js';
+function buildCanonicalUrl(product, slug) {
+    const trimmed = slug.replace(/^\/+|\/+$/g, '');
+    if (!trimmed)
+        return `${DOC_BASE_URLS[product]}/`;
+    // .md mirror suffix points agents at the LLM-canonical Markdown surface.
+    // All four ecosystem sites (derod, tela, hologram, deropay) now ship the
+    // App Router .md mirror route, so the suffix applies universally.
+    return `${DOC_BASE_URLS[product]}/${trimmed}.md`;
+}
+/**
+ * Build a DeroCitation pointing at one bundled docs page.
+ *
+ * The title is required (not derived from the bundled index) so this helper
+ * stays synchronous and zero-IO. It must match the docs page title; the
+ * citation guard validates this against the bundled index in CI.
+ */
+export function buildDeroCitation(product, slug, title) {
+    return {
+        source: 'dero_docs',
+        product,
+        slug,
+        title,
+        canonical_url: buildCanonicalUrl(product, slug),
+        page_id: slug,
+    };
+}
+export const RELATED_DOCS_BY_TOOL = {
+    dero_get_info: [
+        {
+            product: 'derod',
+            slug: 'rpc-api/daemon-rpc-api',
+            title: 'DERO Daemon RPC API: Complete Reference Guide | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'basics/daemon',
+            title: 'DERO Daemon: Backbone of the Privacy Blockchain | DERO Blockchain',
+        },
+    ],
+    dero_get_sc: [
+        {
+            product: 'derod',
+            slug: 'dvm/smart-contract-fundamentals',
+            title: 'Smart Contract Fundamentals: Understanding DERO Contracts | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'dvm/dero-virtual-machine',
+            title: 'DERO Virtual Machine (DVM): Private Smart Contract Platform | DERO Blockchain',
+        },
+    ],
+    dero_get_gas_estimate: [
+        {
+            product: 'derod',
+            slug: 'rpc-api/daemon-rpc-api',
+            title: 'DERO Daemon RPC API: Complete Reference Guide | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'dvm/create-deploy-use-smart-contract',
+            title: 'Create, Deploy & Use a Smart Contract on DERO | Step-by-Step Tutorial',
+        },
+    ],
+    diagnose_chain_health: [
+        {
+            product: 'derod',
+            slug: 'basics/daemon',
+            title: 'DERO Daemon: Backbone of the Privacy Blockchain | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'rpc-api/daemon-rpc-api',
+            title: 'DERO Daemon RPC API: Complete Reference Guide | DERO Blockchain',
+        },
+    ],
+    trace_transaction_with_context: [
+        {
+            product: 'derod',
+            slug: 'rpc-api/daemon-rpc-api',
+            title: 'DERO Daemon RPC API: Complete Reference Guide | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'dvm/smart-contract-fundamentals',
+            title: 'Smart Contract Fundamentals: Understanding DERO Contracts | DERO Blockchain',
+        },
+    ],
+    estimate_deploy_cost: [
+        {
+            product: 'derod',
+            slug: 'dvm/create-deploy-use-smart-contract',
+            title: 'Create, Deploy & Use a Smart Contract on DERO | Step-by-Step Tutorial',
+        },
+        {
+            product: 'derod',
+            slug: 'dvm/dvm-basic',
+            title: "DVM-BASIC: DERO's Smart Contract Language Guide | DERO Blockchain",
+        },
+    ],
+    dero_decode_proof_string: [
+        {
+            product: 'derod',
+            slug: 'integrity/payload-vs-transaction-proofs',
+            title: 'Proof Types Explained: Transaction vs. Payload Proofs | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'integrity/negative-transfer-protection',
+            title: 'Negative Transfer Protection: Cryptographic Impossibility | DERO Blockchain',
+        },
+    ],
+    audit_chain_artifact_claim: [
+        {
+            product: 'derod',
+            slug: 'integrity/payload-vs-transaction-proofs',
+            title: 'Proof Types Explained: Transaction vs. Payload Proofs | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'integrity/negative-transfer-protection',
+            title: 'Negative Transfer Protection: Cryptographic Impossibility | DERO Blockchain',
+        },
+    ],
+    dero_forge_demo_proof: [
+        {
+            product: 'derod',
+            slug: 'integrity/payload-vs-transaction-proofs',
+            title: 'Proof Types Explained: Transaction vs. Payload Proofs | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'integrity/negative-transfer-protection',
+            title: 'Negative Transfer Protection: Cryptographic Impossibility | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'integrity/range-proof-integrity',
+            title: "Range Proof Integrity: How DERO's Bulletproof Binds Amounts | DERO Blockchain",
+        },
+    ],
+    // Composite #2 (`explain_smart_contract`) curates all four DVM docs so its
+    // heuristic can elevate whichever page best matches the detected surface
+    // (token / registry / minimal / generic). The composite re-orders this
+    // array at runtime; the static ordering here is the fallback when the
+    // heuristic returns the same slug already at index 0 (the universal
+    // "fundamentals" default).
+    explain_smart_contract: [
+        {
+            product: 'derod',
+            slug: 'dvm/smart-contract-fundamentals',
+            title: 'Smart Contract Fundamentals: Understanding DERO Contracts | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'dvm/dvm-basic',
+            title: "DVM-BASIC: DERO's Smart Contract Language Guide | DERO Blockchain",
+        },
+        {
+            product: 'derod',
+            slug: 'dvm/dero-virtual-machine',
+            title: 'DERO Virtual Machine (DVM): Private Smart Contract Platform | DERO Blockchain',
+        },
+        {
+            product: 'derod',
+            slug: 'dvm/create-deploy-use-smart-contract',
+            title: 'Create, Deploy & Use a Smart Contract on DERO | Step-by-Step Tutorial',
+        },
+    ],
+};
+/**
+ * Resolve the hand-curated related docs list for a tool name and return it
+ * as fully-built `DeroCitation` objects. Returns `undefined` when the tool
+ * has no related docs configured.
+ *
+ * Use in tool handlers like:
+ *   const related_docs = relatedDocsFor('dero_get_sc')
+ *   return { ...rpcResult, ...(related_docs ? { related_docs } : {}) }
+ */
+export function relatedDocsFor(toolName) {
+    const entries = RELATED_DOCS_BY_TOOL[toolName];
+    if (!entries || entries.length === 0)
+        return undefined;
+    return entries.map((entry) => buildDeroCitation(entry.product, entry.slug, entry.title));
+}
+export const FLAGGED_CHAIN_ARTIFACTS = [
+    {
+        id: '2022-inflation-claim',
+        matchers: [
+            { kind: 'topoheight', value: 1_081_893 },
+            { kind: 'block_hash', value: 'b6bd914f7fb1c79788fe8676c277e58e7bb5a904317afb096b1d2793af9aed13' },
+            { kind: 'tx_hash', value: '5bbe1b7eecfe3447cb045b1197a07a214b456968eda8a3d5a90f5fae9ce57e55' },
+            {
+                kind: 'proof_string',
+                value: 'deroproof1qyyj0cgu3htmkumr79sgca75vwsx8kx7zkrjg0nfez46w36qyx4kwq9zvfyyskpqvdpcfhkhk4m7y9d77ehyj7yhnnrv9z0tjr9m5fqe2yx9t27dwtdxy4j4r0llll7vcmaxwjcl8jzfq',
+            },
+        ],
+        context_note: 'This block/transaction/proof string appears in publicly circulated 2022 inflation claims. The cited payload proof is a user-supplied display object — not a consensus record — and the alleged negative-transfer mechanism cannot produce a verifying range proof. See related_docs for the technical rebuttal.',
+        demo_amount_dero: '-2200000.00181',
+        // TODO: once `integrity/inflation-claim` ships and the bundled docs index
+        // refreshes, prepend it as the primary citation:
+        //   { product: 'derod', slug: 'integrity/inflation-claim', title: '<exact bundled title>' }
+        related_docs: [
+            {
+                product: 'derod',
+                slug: 'integrity/negative-transfer-protection',
+                title: 'Negative Transfer Protection: Cryptographic Impossibility | DERO Blockchain',
+            },
+            {
+                product: 'derod',
+                slug: 'integrity/payload-vs-transaction-proofs',
+                title: 'Proof Types Explained: Transaction vs. Payload Proofs | DERO Blockchain',
+            },
+            {
+                product: 'derod',
+                slug: 'integrity/ring-member-behavior',
+                title: 'Ring Member Behavior: Understanding Decoy Participation | DERO Blockchain',
+            },
+        ],
+    },
+];
+/** Normalize a hex value for case-insensitive comparison. Non-hex strings pass through unchanged. */
+function normalizeHex(value) {
+    return value.trim().toLowerCase();
+}
+/**
+ * Return all flagged artifacts whose matchers fire against the given inputs.
+ *
+ * Multiple matches return multiple artifacts (rare today; would happen if the
+ * same TX got cited in multiple false claims). Tool handlers should merge all
+ * matches into a single response.
+ */
+export function flaggedArtifactsForInput(query) {
+    const matches = [];
+    const queryBlockHash = query.block_hash ? normalizeHex(query.block_hash) : undefined;
+    const queryTxHashes = [];
+    if (query.tx_hash)
+        queryTxHashes.push(normalizeHex(query.tx_hash));
+    if (query.tx_hashes)
+        for (const h of query.tx_hashes)
+            queryTxHashes.push(normalizeHex(h));
+    const queryProof = query.proof_string?.trim();
+    for (const artifact of FLAGGED_CHAIN_ARTIFACTS) {
+        const hit = artifact.matchers.some((m) => {
+            switch (m.kind) {
+                case 'topoheight':
+                    return query.topoheight !== undefined && query.topoheight === m.value;
+                case 'block_hash':
+                    return queryBlockHash !== undefined && queryBlockHash === normalizeHex(m.value);
+                case 'tx_hash':
+                    return queryTxHashes.includes(normalizeHex(m.value));
+                case 'proof_string':
+                    return queryProof !== undefined && queryProof === m.value;
+            }
+        });
+        if (hit)
+            matches.push(artifact);
+    }
+    return matches;
+}
+/**
+ * Build the response-side enrichment for matched artifacts: a context note
+ * (joined if multiple match) plus prepended citations for each match.
+ *
+ * `baseRelatedDocs` is the tool's existing relatedDocsFor() output (or undefined).
+ * Returns `undefined` when no artifacts match — caller should noop in that case.
+ *
+ * Usage in a tool handler:
+ *   const enrichment = enrichWithFlaggedArtifacts(
+ *     { topoheight: args.topoheight },
+ *     relatedDocsFor('dero_get_block_header_by_topo_height'),
+ *   )
+ *   return { ...result, ...(enrichment ?? {}) }
+ */
+export function enrichWithFlaggedArtifacts(query, baseRelatedDocs) {
+    const matches = flaggedArtifactsForInput(query);
+    if (matches.length === 0)
+        return undefined;
+    const context_note = matches.map((a) => a.context_note).join('\n\n');
+    // Prepend artifact citations (de-duped against baseline by canonical_url).
+    const seen = new Set();
+    const merged = [];
+    for (const artifact of matches) {
+        for (const entry of artifact.related_docs) {
+            const cite = buildDeroCitation(entry.product, entry.slug, entry.title);
+            if (!seen.has(cite.canonical_url)) {
+                merged.push(cite);
+                seen.add(cite.canonical_url);
+            }
+        }
+    }
+    if (baseRelatedDocs) {
+        for (const cite of baseRelatedDocs) {
+            if (!seen.has(cite.canonical_url)) {
+                merged.push(cite);
+                seen.add(cite.canonical_url);
+            }
+        }
+    }
+    return { context_note, related_docs: merged };
+}
+//# sourceMappingURL=citations.js.map

package/dist/citations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.js","sourceRoot":"","sources":["../src/citations.ts"],"names":[],"mappings":"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"}

package/dist/composites/_shared.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Shared utilities for DERO MCP composite tools.
+ *
+ * A composite tool stitches several primitives (daemon RPC reads + bundled
+ * docs lookups) into one intent-shaped response. These utilities exist so
+ * every composite handles failures, latency tracking, and citation
+ * attachment the same way.
+ *
+ * Anything reused by more than one composite belongs here. Composite-local
+ * helpers (e.g. narrative builders specific to one composite's response
+ * shape) should live next to that composite, not in this file.
+ *
+ * See the composite design contract for which
+ * utilities live here and the gate every composite must satisfy before it
+ * lands on main.
+ */
+import { type DeroCitation } from '../citations.js';
+/**
+ * One step in a composite's internal chain.
+ *
+ * `required: true` aborts the chain if the step throws (use for liveness
+ * gates like `DERO.Ping`). `required: false` lets the chain continue with
+ * a degraded payload (use for enrichments like a mempool snapshot).
+ */
+export type ChainStep<T = unknown> = {
+    name: string;
+    required?: boolean;
+    fn: () => Promise<T>;
+};
+export type ChainStepResult = {
+    name: string;
+    ok: boolean;
+    value?: unknown;
+    error?: {
+        message: string;
+    };
+    latencyMs: number;
+};
+export type ChainResult = {
+    results: ChainStepResult[];
+    haltedAt: string | null;
+    totalMs: number;
+};
+/**
+ * Run a chain of named primitive calls sequentially. Required-step
+ * failures halt the chain and record `haltedAt`; non-required failures
+ * are recorded and the chain continues. Step latencies are captured so
+ * composites can attach diagnostics to a degraded response.
+ */
+export declare function runChain(steps: readonly ChainStep[]): Promise<ChainResult>;
+/**
+ * Extract a single step's successful return value from a ChainResult.
+ * Returns null when the step was skipped (chain halted earlier), failed,
+ * or simply was not part of the chain.
+ */
+export declare function stepValue<T = unknown>(chain: ChainResult, name: string): T | null;
+/**
+ * Per-step latency map suitable for embedding in a composite's response
+ * under a `_diagnostics` field. Lets agents and operators see which step
+ * was slow without needing to instrument the host.
+ */
+export declare function stepLatencies(chain: ChainResult): Record<string, number>;
+/**
+ * Attach curated `related_docs` citations to a composite's payload.
+ * Mirrors how primitives attach citations so the response shape stays
+ * uniform across primitives and composites. Returns the payload
+ * unchanged when no curated docs are configured for the tool name.
+ */
+export declare function attachCitations<T extends Record<string, unknown>>(payload: T, toolName: string): T & {
+    related_docs?: DeroCitation[];
+};
+/**
+ * Shape used by the JSON-RPC `rpc` closure created in `src/server.ts`.
+ * Re-declared here so composites can take it as a dependency without
+ * importing from the server module (keeps the composite layer free of
+ * `McpServer` coupling).
+ */
+export type DeroDaemonRpc = <T = unknown>(method: string, params?: unknown) => Promise<T>;
+/**
+ * Loose representation of a `DERO.GetSC` response. Field names match the
+ * daemon's actual JSON keys observed on the public node. `uint64keys` is
+ * frequently absent (the daemon omits empty maps), so it is optional.
+ */
+export type DeroGetScResult = {
+    code?: string;
+    status?: string;
+    balance?: number;
+    balances?: Record<string, number>;
+    stringkeys?: Record<string, unknown>;
+    uint64keys?: Record<string, unknown>;
+    [k: string]: unknown;
+};
+export type DvmFunctionSignature = {
+    name: string;
+    args: string[];
+    returns: string;
+};
+export type DeroScSurface = {
+    functions: DvmFunctionSignature[];
+    stringkeys: string[];
+    uint64keys: string[];
+    balances: Record<string, number | string>;
+    raw_code_length: number;
+    has_code: boolean;
+};
+/**
+ * Convert a raw DERO.GetSC payload into a stable, agent-friendly surface.
+ *
+ * Behavior:
+ *  - Returns `functions: []` when `code` is missing or the regex finds
+ *    no Function declarations. Never throws on malformed code.
+ *  - Sorts `stringkeys` / `uint64keys` alphabetically for deterministic
+ *    output across invocations.
+ *  - `balances` is passed through unchanged so callers can render asset
+ *    balances; native DERO balance lives under `balance` on the raw
+ *    payload and is left for callers to decide whether to surface.
+ */
+export declare function extractScSurface(raw: DeroGetScResult | null | undefined): DeroScSurface;
+//# sourceMappingURL=_shared.d.ts.map

package/dist/composites/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/composites/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAkChF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAIjF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,MAAM,GACf,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,CAIvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAUzF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,oBAAoB,EAAE,CAAA;IACjC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AA+BD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAqBvF"}

package/dist/composites/_shared.js

@@ -0,0 +1,152 @@
+/**
+ * Shared utilities for DERO MCP composite tools.
+ *
+ * A composite tool stitches several primitives (daemon RPC reads + bundled
+ * docs lookups) into one intent-shaped response. These utilities exist so
+ * every composite handles failures, latency tracking, and citation
+ * attachment the same way.
+ *
+ * Anything reused by more than one composite belongs here. Composite-local
+ * helpers (e.g. narrative builders specific to one composite's response
+ * shape) should live next to that composite, not in this file.
+ *
+ * See the composite design contract for which
+ * utilities live here and the gate every composite must satisfy before it
+ * lands on main.
+ */
+import { relatedDocsFor } from '../citations.js';
+/**
+ * Run a chain of named primitive calls sequentially. Required-step
+ * failures halt the chain and record `haltedAt`; non-required failures
+ * are recorded and the chain continues. Step latencies are captured so
+ * composites can attach diagnostics to a degraded response.
+ */
+export async function runChain(steps) {
+    const results = [];
+    const startedAt = performance.now();
+    let haltedAt = null;
+    for (const step of steps) {
+        const stepStart = performance.now();
+        try {
+            const value = await step.fn();
+            results.push({
+                name: step.name,
+                ok: true,
+                value,
+                latencyMs: Math.round(performance.now() - stepStart),
+            });
+        }
+        catch (error) {
+            results.push({
+                name: step.name,
+                ok: false,
+                error: { message: error instanceof Error ? error.message : String(error) },
+                latencyMs: Math.round(performance.now() - stepStart),
+            });
+            if (step.required) {
+                haltedAt = step.name;
+                break;
+            }
+        }
+    }
+    return {
+        results,
+        haltedAt,
+        totalMs: Math.round(performance.now() - startedAt),
+    };
+}
+/**
+ * Extract a single step's successful return value from a ChainResult.
+ * Returns null when the step was skipped (chain halted earlier), failed,
+ * or simply was not part of the chain.
+ */
+export function stepValue(chain, name) {
+    const entry = chain.results.find((r) => r.name === name);
+    if (!entry || !entry.ok)
+        return null;
+    return entry.value;
+}
+/**
+ * Per-step latency map suitable for embedding in a composite's response
+ * under a `_diagnostics` field. Lets agents and operators see which step
+ * was slow without needing to instrument the host.
+ */
+export function stepLatencies(chain) {
+    const out = {};
+    for (const r of chain.results)
+        out[r.name] = r.latencyMs;
+    return out;
+}
+/**
+ * Attach curated `related_docs` citations to a composite's payload.
+ * Mirrors how primitives attach citations so the response shape stays
+ * uniform across primitives and composites. Returns the payload
+ * unchanged when no curated docs are configured for the tool name.
+ */
+export function attachCitations(payload, toolName) {
+    const related_docs = relatedDocsFor(toolName);
+    if (!related_docs || related_docs.length === 0)
+        return payload;
+    return { ...payload, related_docs };
+}
+// DVM-BASIC function declaration:
+//   Function Name(arg Type, ...) Uint64|String
+//
+// Anchored with `/m` so each line of source is examined independently.
+// Tolerant of leading whitespace and varied spacing inside the parens.
+const DVM_FUNCTION_REGEX = /^[ \t]*Function[ \t]+([A-Za-z_][A-Za-z0-9_]*)[ \t]*\(([^)]*)\)[ \t]*(Uint64|String)\b/gm;
+function parseDvmFunctions(code) {
+    const out = [];
+    const seen = new Set();
+    for (const match of code.matchAll(DVM_FUNCTION_REGEX)) {
+        const name = match[1];
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        const argsRaw = (match[2] ?? '').trim();
+        const returns = match[3] ?? '';
+        const args = argsRaw.length === 0
+            ? []
+            : argsRaw
+                .split(',')
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0);
+        out.push({ name, args, returns });
+    }
+    return out;
+}
+/**
+ * Convert a raw DERO.GetSC payload into a stable, agent-friendly surface.
+ *
+ * Behavior:
+ *  - Returns `functions: []` when `code` is missing or the regex finds
+ *    no Function declarations. Never throws on malformed code.
+ *  - Sorts `stringkeys` / `uint64keys` alphabetically for deterministic
+ *    output across invocations.
+ *  - `balances` is passed through unchanged so callers can render asset
+ *    balances; native DERO balance lives under `balance` on the raw
+ *    payload and is left for callers to decide whether to surface.
+ */
+export function extractScSurface(raw) {
+    const code = typeof raw?.code === 'string' ? raw.code : '';
+    const functions = code.length > 0 ? parseDvmFunctions(code) : [];
+    const stringkeys = raw?.stringkeys ? Object.keys(raw.stringkeys).sort() : [];
+    const uint64keys = raw?.uint64keys ? Object.keys(raw.uint64keys).sort() : [];
+    const balances = {};
+    if (raw?.balances && typeof raw.balances === 'object') {
+        for (const [scid, amount] of Object.entries(raw.balances)) {
+            if (typeof amount === 'number' || typeof amount === 'string') {
+                balances[scid] = amount;
+            }
+        }
+    }
+    return {
+        functions,
+        stringkeys,
+        uint64keys,
+        balances,
+        raw_code_length: code.length,
+        has_code: code.length > 0,
+    };
+}
+//# sourceMappingURL=_shared.js.map

package/dist/composites/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../src/composites/_shared.ts"],"names":[],"mappings":"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"}