@ddse/acm-sdk 0.5.0

package/dist/src/context-provider.d.ts

@@ -0,0 +1,36 @@
+import type { Nucleus } from './nucleus.js';
+import type { RunContext, InternalContextScope } from './types.js';
+import type { Tool } from './tool.js';
+export type ContextRetrievalArtifact = {
+    type: string;
+    content: any;
+    promote?: boolean;
+    provenance?: {
+        tool?: string;
+        rationale?: string;
+        [key: string]: any;
+    };
+};
+export type ContextRetrievalResult = ContextRetrievalArtifact | ContextRetrievalArtifact[] | null | undefined;
+export type ContextRetrievalTool = Tool<any, ContextRetrievalResult>;
+export type ContextRetrievalBindingOptions = {
+    match?: (directive: string) => boolean;
+    buildInput?: (directive: string, context: {
+        runContext?: RunContext;
+        nucleus?: Nucleus;
+    }) => any;
+    autoPromote?: boolean;
+    maxArtifacts?: number;
+    describe?: string;
+};
+export declare class ExternalContextProviderAdapter {
+    private bindings;
+    register(tool: ContextRetrievalTool, options?: ContextRetrievalBindingOptions): void;
+    fulfill(request: {
+        directives: string[];
+        scope: InternalContextScope;
+        runContext?: RunContext;
+        nucleus?: Nucleus;
+    }): Promise<void>;
+}
+//# sourceMappingURL=context-provider.d.ts.map

package/dist/src/context-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-provider.d.ts","sourceRoot":"","sources":["../../src/context-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B,wBAAwB,GACxB,wBAAwB,EAAE,GAC1B,IAAI,GACJ,SAAS,CAAC;AAEd,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;AAErE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,KACE,GAAG,CAAC;IACT,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAiBF,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAiB;IAEjC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,IAAI;IA0B9E,OAAO,CAAC,OAAO,EAAE;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,EAAE,oBAAoB,CAAC;QAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;CAiDlB"}

package/dist/src/context-provider.js

@@ -0,0 +1,59 @@
+export class ExternalContextProviderAdapter {
+    bindings = [];
+    register(tool, options) {
+        const match = options?.match ??
+            ((directive) => directive.startsWith(`${tool.name()}:`) || directive.startsWith(`${tool.name()}::`));
+        const buildInput = options?.buildInput ?? ((directive) => {
+            const separatorIndex = directive.indexOf(':');
+            const payload = separatorIndex >= 0 ? directive.slice(separatorIndex + 1) : undefined;
+            return {
+                directive,
+                payload,
+            };
+        });
+        this.bindings.push({
+            tool,
+            match,
+            buildInput,
+            autoPromote: options?.autoPromote ?? true,
+            maxArtifacts: options?.maxArtifacts ?? 16,
+            describe: options?.describe,
+        });
+    }
+    async fulfill(request) {
+        const { directives, scope, runContext, nucleus } = request;
+        const unresolved = [];
+        for (const directive of directives) {
+            const binding = this.bindings.find(entry => entry.match(directive));
+            if (!binding) {
+                unresolved.push(directive);
+                continue;
+            }
+            const input = binding.buildInput(directive, { runContext, nucleus });
+            const result = await binding.tool.call(input);
+            if (!result) {
+                continue;
+            }
+            const artifacts = Array.isArray(result) ? result : [result];
+            if (artifacts.length > binding.maxArtifacts) {
+                throw new Error(`Tool ${binding.tool.name()} returned ${artifacts.length} artifacts for directive ${directive}, exceeding limit ${binding.maxArtifacts}`);
+            }
+            for (const artifact of artifacts) {
+                if (!artifact || typeof artifact.type !== 'string') {
+                    throw new Error(`Tool ${binding.tool.name()} returned an invalid artifact for directive ${directive}`);
+                }
+                const provenance = artifact.provenance ?? {
+                    tool: binding.tool.name(),
+                };
+                const artifactId = scope.addArtifact(artifact.type, artifact.content, provenance);
+                if (artifact.promote ?? binding.autoPromote) {
+                    await scope.promote(artifactId);
+                }
+            }
+        }
+        if (unresolved.length > 0) {
+            throw new Error(`No context retrieval tool registered for directives: ${unresolved.join(', ')}`);
+        }
+    }
+}
+//# sourceMappingURL=context-provider.js.map

package/dist/src/context-provider.js.map

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

package/dist/src/context.d.ts

@@ -0,0 +1,42 @@
+import type { ContextPacket, InternalContextScope, LedgerEntry } from './types.js';
+export declare class ContextBuilder {
+    private sources;
+    private facts;
+    private assumptions;
+    private augmentations;
+    private provenance;
+    addSource(uri: string, type?: string, content?: any): this;
+    addFact(key: string, value: any): this;
+    addFacts(facts: Record<string, any>): this;
+    addAssumption(assumption: string): this;
+    addAugmentation(type: string, artifact: string): this;
+    setProvenance(provenance: ContextPacket['provenance']): this;
+    build(version?: string): ContextPacket;
+    private computePacketId;
+    private computeDigest;
+    static computeContextRef(context: ContextPacket): string;
+}
+export declare class InternalContextScopeImpl implements InternalContextScope {
+    artifacts: Array<{
+        id: string;
+        type: string;
+        content: any;
+        digest: string;
+        provenance?: {
+            retrievedAt: number;
+            tool?: string;
+            rationale?: string;
+        };
+    }>;
+    private ledgerAppend?;
+    private contextBuilder?;
+    constructor(ledgerAppend?: (entry: LedgerEntry) => void);
+    addArtifact(type: string, content: any, provenance?: {
+        tool?: string;
+        rationale?: string;
+    }): string;
+    promote(artifactId: string): Promise<void>;
+    getArtifact(id: string): any;
+    private computeDigest;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnF,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,UAAU,CAAmC;IAErD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,IAAI;IAM1D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAKtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAK1C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKvC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrD,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,IAAI;IAK5D,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa;IActC,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,aAAa;IAMrB,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;CAYzD;AAED,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,GAAG,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC,CAAM;IAER,OAAO,CAAC,YAAY,CAAC,CAA+B;IACpD,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAIvD,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,EACZ,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,MAAM;IAmCH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG;IAK5B,OAAO,CAAC,aAAa;CAKtB"}

package/dist/src/context.js

@@ -0,0 +1,148 @@
+// Context orchestration utilities
+import { createHash } from 'crypto';
+export class ContextBuilder {
+    sources = [];
+    facts = {};
+    assumptions = [];
+    augmentations = [];
+    provenance = {};
+    addSource(uri, type, content) {
+        const digest = this.computeDigest(content ? JSON.stringify(content) : uri);
+        this.sources.push({ uri, digest, type });
+        return this;
+    }
+    addFact(key, value) {
+        this.facts[key] = value;
+        return this;
+    }
+    addFacts(facts) {
+        Object.assign(this.facts, facts);
+        return this;
+    }
+    addAssumption(assumption) {
+        this.assumptions.push(assumption);
+        return this;
+    }
+    addAugmentation(type, artifact) {
+        this.augmentations.push({ type, artifact });
+        return this;
+    }
+    setProvenance(provenance) {
+        this.provenance = provenance;
+        return this;
+    }
+    build(version) {
+        const packet = {
+            id: this.computePacketId(),
+            version,
+            sources: this.sources,
+            facts: this.facts,
+            assumptions: this.assumptions.length > 0 ? this.assumptions : undefined,
+            augmentations: this.augmentations,
+            provenance: this.provenance,
+        };
+        return packet;
+    }
+    computePacketId() {
+        // Compute SHA-256 hash of the normalized packet
+        const normalized = JSON.stringify({
+            sources: this.sources,
+            facts: this.facts,
+            assumptions: this.assumptions,
+            augmentations: this.augmentations,
+        });
+        const hash = createHash('sha256');
+        hash.update(normalized);
+        return `sha256-${hash.digest('hex')}`;
+    }
+    computeDigest(content) {
+        const hash = createHash('sha256');
+        hash.update(content);
+        return `sha256-${hash.digest('hex').substring(0, 32)}`;
+    }
+    static computeContextRef(context) {
+        // Compute full SHA-256 hash of the normalized context packet
+        const normalized = JSON.stringify({
+            sources: context.sources,
+            facts: context.facts,
+            assumptions: context.assumptions,
+            augmentations: context.augmentations,
+        });
+        const hash = createHash('sha256');
+        hash.update(normalized);
+        return hash.digest('hex');
+    }
+}
+export class InternalContextScopeImpl {
+    artifacts = [];
+    ledgerAppend;
+    contextBuilder;
+    constructor(ledgerAppend) {
+        this.ledgerAppend = ledgerAppend;
+    }
+    addArtifact(type, content, provenance) {
+        const id = `artifact-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+        const digest = this.computeDigest(JSON.stringify(content));
+        this.artifacts.push({
+            id,
+            type,
+            content,
+            digest,
+            provenance: provenance
+                ? {
+                    retrievedAt: Date.now(),
+                    ...provenance,
+                }
+                : undefined,
+        });
+        // Record to ledger
+        if (this.ledgerAppend) {
+            this.ledgerAppend({
+                id: `context-internal-${Date.now()}-${Math.random().toString(36).substring(7)}`,
+                ts: Date.now(),
+                type: 'CONTEXT_INTERNALIZED',
+                details: {
+                    artifactId: id,
+                    type,
+                    digest,
+                    provenance,
+                },
+            });
+        }
+        return id;
+    }
+    async promote(artifactId) {
+        const artifact = this.artifacts.find(a => a.id === artifactId);
+        if (!artifact) {
+            throw new Error(`Artifact not found: ${artifactId}`);
+        }
+        // In a real implementation, this would create a new Context Packet version
+        // and append to the context builder
+        if (this.contextBuilder) {
+            this.contextBuilder.addAugmentation(artifact.type, artifact.id);
+        }
+        // Log promotion
+        if (this.ledgerAppend) {
+            this.ledgerAppend({
+                id: `context-promote-${Date.now()}-${Math.random().toString(36).substring(7)}`,
+                ts: Date.now(),
+                type: 'CONTEXT_INTERNALIZED',
+                details: {
+                    action: 'promote',
+                    artifactId,
+                    digest: artifact.digest,
+                },
+            });
+        }
+    }
+    getArtifact(id) {
+        const artifact = this.artifacts.find(a => a.id === id);
+        return artifact?.content;
+    }
+    computeDigest(content) {
+        const hash = createHash('sha256');
+        hash.update(content);
+        return hash.digest('hex').substring(0, 32);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC,MAAM,OAAO,cAAc;IACjB,OAAO,GAA6B,EAAE,CAAC;IACvC,KAAK,GAAwB,EAAE,CAAC;IAChC,WAAW,GAAa,EAAE,CAAC;IAC3B,aAAa,GAAmC,EAAE,CAAC;IACnD,UAAU,GAAgC,EAAE,CAAC;IAErD,SAAS,CAAC,GAAW,EAAE,IAAa,EAAE,OAAa;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,KAAU;QAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,KAA0B;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,eAAe,CAAC,IAAY,EAAE,QAAgB;QAC5C,IAAI,CAAC,aAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,UAAuC;QACnD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAgB;QACpB,MAAM,MAAM,GAAkB;YAC5B,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE;YAC1B,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;YACvE,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe;QACrB,gDAAgD;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACxC,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,OAAsB;QAC7C,6DAA6D;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,wBAAwB;IACnC,SAAS,GAUJ,EAAE,CAAC;IAEA,YAAY,CAAgC;IAC5C,cAAc,CAAkB;IAExC,YAAY,YAA2C;QACrD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,WAAW,CACT,IAAY,EACZ,OAAY,EACZ,UAGC;QAED,MAAM,EAAE,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAE3D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAClB,EAAE;YACF,IAAI;YACJ,OAAO;YACP,MAAM;YACN,UAAU,EAAE,UAAU;gBACpB,CAAC,CAAC;oBACE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;oBACvB,GAAG,UAAU;iBACd;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QAEH,mBAAmB;QACnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC;gBAChB,EAAE,EAAE,oBAAoB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;gBAC/E,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE;oBACP,UAAU,EAAE,EAAE;oBACd,IAAI;oBACJ,MAAM;oBACN,UAAU;iBACX;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,2EAA2E;QAC3E,oCAAoC;QACpC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,gBAAgB;QAChB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC;gBAChB,EAAE,EAAE,mBAAmB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;gBAC9E,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE;oBACP,MAAM,EAAE,SAAS;oBACjB,UAAU;oBACV,MAAM,EAAE,QAAQ,CAAC,MAAM;iBACxB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,QAAQ,EAAE,OAAO,CAAC;IAC3B,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+export * from './types.js';
+export * from './tool.js';
+export * from './task.js';
+export * from './capability.js';
+export * from './registry.js';
+export * from './policy.js';
+export * from './stream.js';
+export * from './nucleus.js';
+export * from './context.js';
+export * from './context-provider.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,13 @@
+// SDK exports
+export * from './types.js';
+export * from './tool.js';
+export * from './task.js';
+export * from './capability.js';
+export * from './registry.js';
+export * from './policy.js';
+export * from './stream.js';
+export * from './nucleus.js';
+export * from './context.js';
+export * from './context-provider.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/src/nucleus.d.ts

@@ -0,0 +1,105 @@
+import type { Context, InternalContextScope, LedgerEntry } from './types.js';
+export type NucleusToolDefinition = {
+    name: string;
+    description?: string;
+    inputSchema?: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+};
+export type StructuredToolCall = {
+    id?: string;
+    name: string;
+    input: Record<string, any>;
+    output?: Record<string, any>;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+export type NucleusInvokeRequest = {
+    prompt?: string;
+    input?: any;
+    tools?: NucleusToolDefinition[];
+};
+export type NucleusInvokeResult = {
+    reasoning?: string;
+    toolCalls: StructuredToolCall[];
+    raw?: any;
+};
+export type NucleusConfig = {
+    goalId: string;
+    goalIntent: string;
+    planId?: string;
+    taskId?: string;
+    contextRef: string;
+    context?: Context;
+    llmCall: {
+        provider: string;
+        model: string;
+        temperature?: number;
+        seed?: number;
+        maxTokens?: number;
+    };
+    allowedTools?: string[];
+    hooks?: {
+        preflight?: boolean;
+        postcheck?: boolean;
+    };
+    promptTemplate?: string;
+    promptDigest?: string;
+};
+export type PreflightResult = {
+    status: 'OK';
+} | {
+    status: 'NEEDS_CONTEXT';
+    retrievalDirectives: string[];
+};
+export type PostcheckResult = {
+    status: 'COMPLETE';
+} | {
+    status: 'NEEDS_COMPENSATION';
+    reason: string;
+} | {
+    status: 'ESCALATE';
+    reason: string;
+};
+export type LLMCallFn = (prompt: string, tools: NucleusToolDefinition[], config: NucleusConfig['llmCall']) => Promise<{
+    reasoning?: string;
+    toolCalls: StructuredToolCall[];
+    raw?: any;
+}>;
+export declare abstract class Nucleus {
+    protected config: NucleusConfig;
+    constructor(config: NucleusConfig);
+    abstract preflight(): Promise<PreflightResult>;
+    abstract invoke(request: NucleusInvokeRequest): Promise<NucleusInvokeResult>;
+    abstract postcheck(output: any): Promise<PostcheckResult>;
+    abstract recordInference(promptDigest: string, toolCalls: StructuredToolCall[], reasoning?: string): LedgerEntry;
+    abstract getInternalContext(): InternalContextScope | undefined;
+    abstract setInternalContext(scope: InternalContextScope): void;
+    getConfig(): NucleusConfig;
+}
+export declare class DeterministicNucleus extends Nucleus {
+    private llmCall;
+    private ledgerAppend;
+    private internalContext?;
+    private ledger;
+    constructor(config: NucleusConfig, llmCall: LLMCallFn, ledgerAppend: (entry: LedgerEntry) => void);
+    preflight(): Promise<PreflightResult>;
+    invoke(request: NucleusInvokeRequest): Promise<NucleusInvokeResult>;
+    postcheck(output: any): Promise<PostcheckResult>;
+    recordInference(promptDigest: string, toolCalls: StructuredToolCall[], reasoning?: string): LedgerEntry;
+    getInternalContext(): InternalContextScope | undefined;
+    setInternalContext(scope: InternalContextScope): void;
+    private callLLM;
+    private buildPreflightPrompt;
+    private buildInvokePrompt;
+    private buildPostcheckPrompt;
+    private computePromptDigest;
+    private computeDigest;
+    private renderContextSnapshot;
+}
+export type NucleusFactory = (config: NucleusConfig) => Nucleus;
+//# sourceMappingURL=nucleus.d.ts.map

package/dist/src/nucleus.d.ts.map

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

package/dist/src/nucleus.js

@@ -0,0 +1,208 @@
+// Nucleus contract for LLM-native task and planner execution
+import { createHash } from 'crypto';
+export class Nucleus {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+export class DeterministicNucleus extends Nucleus {
+    llmCall;
+    ledgerAppend;
+    internalContext;
+    ledger = [];
+    constructor(config, llmCall, ledgerAppend) {
+        super(config);
+        this.llmCall = llmCall;
+        this.ledgerAppend = ledgerAppend;
+        if (!config.goalIntent || config.goalIntent.trim().length === 0) {
+            throw new Error('NucleusConfig.goalIntent is required for nucleus execution.');
+        }
+    }
+    async preflight() {
+        if (!this.config.hooks?.preflight) {
+            return { status: 'OK' };
+        }
+        const prompt = this.buildPreflightPrompt();
+        const result = await this.callLLM(prompt);
+        const needsContext = result.toolCalls.some(tc => tc.name === 'request_context_retrieval');
+        if (needsContext) {
+            const directives = result.toolCalls
+                .filter(tc => tc.name === 'request_context_retrieval')
+                .map(tc => tc.input?.directive)
+                .filter(Boolean);
+            return {
+                status: 'NEEDS_CONTEXT',
+                retrievalDirectives: directives,
+            };
+        }
+        return { status: 'OK' };
+    }
+    async invoke(request) {
+        const prompt = request.prompt ?? this.buildInvokePrompt(request.input);
+        return this.callLLM(prompt, request.tools);
+    }
+    async postcheck(output) {
+        if (!this.config.hooks?.postcheck) {
+            return { status: 'COMPLETE' };
+        }
+        const prompt = this.buildPostcheckPrompt(output);
+        const result = await this.callLLM(prompt);
+        const compensation = result.toolCalls.find(tc => tc.name === 'request_compensation');
+        if (compensation) {
+            return {
+                status: 'NEEDS_COMPENSATION',
+                reason: compensation.input?.reason || 'Unknown',
+            };
+        }
+        const escalation = result.toolCalls.find(tc => tc.name === 'escalate_issue');
+        if (escalation) {
+            return {
+                status: 'ESCALATE',
+                reason: escalation.input?.reason || 'Unknown',
+            };
+        }
+        return { status: 'COMPLETE' };
+    }
+    recordInference(promptDigest, toolCalls, reasoning) {
+        const envelopes = toolCalls.map((tc, idx) => ({
+            id: tc.id ?? `tool-call-${Date.now()}-${idx}`,
+            name: tc.name,
+            input: tc.input ?? {},
+            output: tc.output,
+            error: tc.error,
+            metadata: {
+                timestamp: Date.now(),
+                digest: this.computeDigest(JSON.stringify(tc.input ?? {})),
+            },
+        }));
+        const entry = {
+            id: `nucleus-inference-${Date.now()}-${Math.random().toString(36).substring(7)}`,
+            ts: Date.now(),
+            type: 'NUCLEUS_INFERENCE',
+            details: {
+                nucleus: {
+                    goalId: this.config.goalId,
+                    planId: this.config.planId,
+                    taskId: this.config.taskId,
+                    contextRef: this.config.contextRef,
+                },
+                llmCall: {
+                    provider: this.config.llmCall.provider,
+                    model: this.config.llmCall.model,
+                    seed: this.config.llmCall.seed,
+                },
+                promptDigest,
+                reasoning,
+                toolCalls: envelopes.map(env => ({
+                    id: env.id,
+                    name: env.name,
+                    inputDigest: env.metadata?.digest,
+                    outputDigest: env.output ? this.computeDigest(JSON.stringify(env.output)) : undefined,
+                })),
+            },
+        };
+        entry.digest = this.computeDigest(JSON.stringify(entry.details));
+        this.ledger.push(entry);
+        this.ledgerAppend(entry);
+        return entry;
+    }
+    getInternalContext() {
+        return this.internalContext;
+    }
+    setInternalContext(scope) {
+        this.internalContext = scope;
+    }
+    async callLLM(prompt, tools = []) {
+        const result = await this.llmCall(prompt, tools, this.config.llmCall);
+        const normalizedCalls = (result.toolCalls ?? []).map((tc, idx) => ({
+            id: tc.id ?? `tool-call-${Date.now()}-${idx}`,
+            name: tc.name,
+            input: tc.input ?? {},
+            output: tc.output,
+            error: tc.error,
+        }));
+        this.recordInference(this.computePromptDigest(prompt), normalizedCalls, result.reasoning);
+        return {
+            reasoning: result.reasoning,
+            toolCalls: normalizedCalls,
+            raw: result.raw,
+        };
+    }
+    buildPreflightPrompt() {
+        return `Assess whether the current context is sufficient for the task.
+Goal: ${this.config.goalId}
+Goal Intent: ${this.config.goalIntent}
+Task: ${this.config.taskId || 'planner'}
+Context Ref: ${this.config.contextRef}
+
+Context Snapshot:
+${this.renderContextSnapshot()}
+
+If additional context is needed, call request_context_retrieval with a directive.`;
+    }
+    buildInvokePrompt(input) {
+        return `Execute the task with the following input:
+${JSON.stringify(input, null, 2)}
+
+Goal: ${this.config.goalId}
+Goal Intent: ${this.config.goalIntent}
+Task: ${this.config.taskId || 'planner'}
+
+Relevant Context:
+${this.renderContextSnapshot()}`;
+    }
+    buildPostcheckPrompt(output) {
+        return `Validate the output and determine if any follow-up is needed:
+${JSON.stringify(output, null, 2)}
+
+Goal: ${this.config.goalId}
+Goal Intent: ${this.config.goalIntent}
+Task: ${this.config.taskId || 'planner'}
+
+Context Reference: ${this.config.contextRef}
+
+If compensation is needed, call request_compensation.
+If escalation is needed, call escalate_issue.`;
+    }
+    computePromptDigest(prompt) {
+        const hash = createHash('sha256');
+        hash.update(prompt);
+        return hash.digest('hex').substring(0, 16);
+    }
+    computeDigest(content) {
+        const hash = createHash('sha256');
+        hash.update(content);
+        return hash.digest('hex').substring(0, 16);
+    }
+    renderContextSnapshot() {
+        const context = this.config.context;
+        if (!context) {
+            return '(No context payload provided; consider supplying context.facts to the nucleus.)';
+        }
+        const pieces = [];
+        if (context.facts && Object.keys(context.facts).length > 0) {
+            pieces.push(`Facts:\n${JSON.stringify(context.facts, null, 2)}`);
+        }
+        else {
+            pieces.push('Facts: {}');
+        }
+        if (context.assumptions && context.assumptions.length > 0) {
+            pieces.push(`Assumptions:\n- ${context.assumptions.join('\n- ')}`);
+        }
+        if (context.constraints_inherited && Object.keys(context.constraints_inherited).length > 0) {
+            pieces.push(`Inherited Constraints:\n${JSON.stringify(context.constraints_inherited, null, 2)}`);
+        }
+        if (context.augmentations && context.augmentations.length > 0) {
+            const augmentations = context.augmentations
+                .map(aug => `- ${aug.type}: ${aug.artifact}`)
+                .join('\n');
+            pieces.push(`Augmentations:\n${augmentations}`);
+        }
+        return pieces.join('\n\n');
+    }
+}
+//# sourceMappingURL=nucleus.js.map