@ddse/acm-examples 0.5.0 → 0.5.2

package/dist/src/examples/entitlement/tasks.d.ts

@@ -0,0 +1,44 @@
+import { Task, type RunContext } from '@acm/sdk';
+export declare class FetchCustomerProfileTask extends Task<{
+    customerId: string;
+}, any> {
+    private readonly tool;
+    constructor();
+    execute(_ctx: RunContext, input: {
+        customerId: string;
+    }): Promise<any>;
+    verification(): string[];
+}
+export declare class EvaluateEntitlementTask extends Task<{
+    customer: any;
+}, {
+    allow: boolean;
+    rationale: string[];
+}> {
+    private readonly tool;
+    constructor();
+    execute(_ctx: RunContext, input: {
+        customer: any;
+    }): Promise<{
+        allow: boolean;
+        rationale: string[];
+    }>;
+    verification(): string[];
+}
+export declare class NotifySupervisorTask extends Task<{
+    customerId: string;
+    reason: string;
+}, {
+    notified: boolean;
+}> {
+    private readonly tool;
+    constructor();
+    execute(_ctx: RunContext, input: {
+        customerId: string;
+        reason: string;
+    }): Promise<{
+        notified: boolean;
+    }>;
+    verification(): string[];
+}
+//# sourceMappingURL=tasks.d.ts.map

package/dist/src/examples/entitlement/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../../src/examples/entitlement/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAGjD,qBAAa,wBAAyB,SAAQ,IAAI,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,CAAC;IAC7E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;;IAEjD,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;IAG7D,YAAY;CACb;AAED,qBAAa,uBAAwB,SAAQ,IAAI,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;IAC3G,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;;IAEhD,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;QAAE,QAAQ,EAAE,GAAG,CAAA;KAAE;;;;IAGxD,YAAY;CACb;AAED,qBAAa,oBAAqB,SAAQ,IAAI,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;IAC3G,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;;IAE7C,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;;;IAG7E,YAAY;CACb"}

package/dist/src/examples/entitlement/tasks.js

@@ -0,0 +1,27 @@
+import { Task } from '@acm/sdk';
+import { FetchCustomerProfileTool, EvaluateEntitlementTool, NotifySupervisorTool } from './tools.js';
+export class FetchCustomerProfileTask extends Task {
+    tool = new FetchCustomerProfileTool();
+    constructor() { super('fetch_profile', 'fetch_customer_profile'); }
+    async execute(_ctx, input) {
+        return this.tool.call({ customerId: input.customerId });
+    }
+    verification() { return ['output != null']; }
+}
+export class EvaluateEntitlementTask extends Task {
+    tool = new EvaluateEntitlementTool();
+    constructor() { super('evaluate_entitlement', 'evaluate_entitlement'); }
+    async execute(_ctx, input) {
+        return this.tool.call({ customer: input.customer });
+    }
+    verification() { return ['typeof output.allow === "boolean"']; }
+}
+export class NotifySupervisorTask extends Task {
+    tool = new NotifySupervisorTool();
+    constructor() { super('notify_supervisor', 'notify_supervisor'); }
+    async execute(_ctx, input) {
+        return this.tool.call({ customerId: input.customerId, reason: input.reason });
+    }
+    verification() { return ['output.notified === true']; }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/src/examples/entitlement/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../../src/examples/entitlement/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErG,MAAM,OAAO,wBAAyB,SAAQ,IAAiC;IAC5D,IAAI,GAAG,IAAI,wBAAwB,EAAE,CAAC;IACvD,gBAAgB,KAAK,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;IACnE,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,KAA6B;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,YAAY,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC9C;AAED,MAAM,OAAO,uBAAwB,SAAQ,IAAgE;IAC1F,IAAI,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACtD,gBAAgB,KAAK,CAAC,sBAAsB,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACxE,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,KAAwB;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,YAAY,KAAK,OAAO,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC;CACjE;AAED,MAAM,OAAO,oBAAqB,SAAQ,IAAmE;IAC1F,IAAI,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACnD,gBAAgB,KAAK,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAClE,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,KAA6C;QAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,YAAY,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;CACxD"}

package/dist/src/examples/entitlement/tools.d.ts

@@ -0,0 +1,74 @@
+import { Tool } from '@acm/sdk';
+export declare class FetchCustomerProfileTool extends Tool<{
+    customerId: string;
+}, any> {
+    name(): string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly customerId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["customerId"];
+        readonly additionalProperties: false;
+    };
+    call(input: {
+        customerId: string;
+    }): Promise<any>;
+}
+export declare class EvaluateEntitlementTool extends Tool<{
+    customer: any;
+}, {
+    allow: boolean;
+    rationale: string[];
+}> {
+    name(): string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly customer: {
+                readonly type: "object";
+            };
+        };
+        readonly required: readonly ["customer"];
+        readonly additionalProperties: true;
+    };
+    call(input: {
+        customer: any;
+    }): Promise<{
+        allow: boolean;
+        rationale: string[];
+    }>;
+}
+export declare class NotifySupervisorTool extends Tool<{
+    customerId: string;
+    reason: string;
+}, {
+    notified: boolean;
+}> {
+    name(): string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly customerId: {
+                readonly type: "string";
+            };
+            readonly reason: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["customerId", "reason"];
+        readonly additionalProperties: false;
+    };
+    call(_input: {
+        customerId: string;
+        reason: string;
+    }): Promise<{
+        notified: boolean;
+    }>;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/src/examples/entitlement/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/examples/entitlement/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGhC,qBAAa,wBAAyB,SAAQ,IAAI,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,CAAC;IAC7E,IAAI;IACJ,WAAW,SAAiD;IAC5D,WAAW;;;;;;;;;MAKA;IAEL,IAAI,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;CAKzC;AAED,qBAAa,uBAAwB,SAAQ,IAAI,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;IAC3G,IAAI;IACJ,WAAW,SAAmE;IAC9E,WAAW;;;;;;;;;MAKA;IAEL,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,GAAG,CAAA;KAAE;;;;CAqBpC;AAED,qBAAa,oBAAqB,SAAQ,IAAI,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;IAC3G,IAAI;IACJ,WAAW,SAAyC;IACpD,WAAW;;;;;;;;;;;;MAQA;IAEL,IAAI,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAG3F"}

package/dist/src/examples/entitlement/tools.js

@@ -0,0 +1,63 @@
+import { Tool } from '@acm/sdk';
+import fs from 'fs/promises';
+export class FetchCustomerProfileTool extends Tool {
+    name() { return 'fetch_customer_profile'; }
+    description = 'Fetch customer profile from synthetic store';
+    inputSchema = {
+        type: 'object',
+        properties: { customerId: { type: 'string' } },
+        required: ['customerId'],
+        additionalProperties: false,
+    };
+    async call(input) {
+        const raw = await fs.readFile(new URL('../../../data/entitlement/customers.json', import.meta.url));
+        const data = JSON.parse(raw.toString());
+        return data.find((c) => c.id === input.customerId) ?? null;
+    }
+}
+export class EvaluateEntitlementTool extends Tool {
+    name() { return 'evaluate_entitlement'; }
+    description = 'Evaluate whether a customer is entitled based on policy rules';
+    inputSchema = {
+        type: 'object',
+        properties: { customer: { type: 'object' } },
+        required: ['customer'],
+        additionalProperties: true,
+    };
+    async call(input) {
+        const raw = await fs.readFile(new URL('../../../data/entitlement/policies.json', import.meta.url));
+        const p = JSON.parse(raw.toString());
+        const rationale = [];
+        if (input.customer.ageMonths < p.minAccountAgeMonths) {
+            rationale.push('Account too new');
+        }
+        if (!p.tiersAllowed.includes(input.customer.tier)) {
+            rationale.push('Tier not eligible');
+        }
+        const deniedByFlag = (input.customer.complianceFlags || []).find((f) => p.denyIfComplianceFlags.includes(f));
+        if (deniedByFlag) {
+            rationale.push(`Compliance flag: ${deniedByFlag}`);
+        }
+        const allow = rationale.length === 0;
+        if (allow)
+            rationale.push('Meets policy criteria');
+        return { allow, rationale };
+    }
+}
+export class NotifySupervisorTool extends Tool {
+    name() { return 'notify_supervisor'; }
+    description = 'Notify supervisor for denial branch';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            customerId: { type: 'string' },
+            reason: { type: 'string' },
+        },
+        required: ['customerId', 'reason'],
+        additionalProperties: false,
+    };
+    async call(_input) {
+        return { notified: true };
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/examples/entitlement/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/examples/entitlement/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,MAAM,OAAO,wBAAyB,SAAQ,IAAiC;IAC7E,IAAI,KAAK,OAAO,wBAAwB,CAAC,CAAC,CAAC;IAC3C,WAAW,GAAG,6CAA6C,CAAC;IAC5D,WAAW,GAAG;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC9C,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,oBAAoB,EAAE,KAAK;KACnB,CAAC;IAEX,KAAK,CAAC,IAAI,CAAC,KAA6B;QACtC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,0CAA0C,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACpG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAClE,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,IAAgE;IAC3G,IAAI,KAAK,OAAO,sBAAsB,CAAC,CAAC,CAAC;IACzC,WAAW,GAAG,+DAA+D,CAAC;IAC9E,WAAW,GAAG;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5C,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,IAAI;KAClB,CAAC;IAEX,KAAK,CAAC,IAAI,CAAC,KAAwB;QACjC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,yCAAyC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnG,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrC,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,mBAAmB,EAAE,CAAC;YACrD,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACrH,IAAI,YAAY,EAAE,CAAC;YACjB,SAAS,CAAC,IAAI,CAAC,oBAAoB,YAAY,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;QACrC,IAAI,KAAK;YAAE,SAAS,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAEnD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,IAAmE;IAC3G,IAAI,KAAK,OAAO,mBAAmB,CAAC,CAAC,CAAC;IACtC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC;QAClC,oBAAoB,EAAE,KAAK;KACnB,CAAC;IAEX,KAAK,CAAC,IAAI,CAAC,MAA8C;QACvD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/src/framework.d.ts

@@ -0,0 +1,19 @@
+import { DefaultStreamSink, ExternalContextProviderAdapter, type CapabilityRegistry } from '@acm/sdk';
+import { ExecutionEngine } from '@acm/framework';
+export type Provider = 'ollama' | 'vllm';
+export interface DemoFrameworkOptions {
+    provider?: Provider;
+    model?: string;
+    baseUrl?: string;
+    capabilityRegistry: CapabilityRegistry;
+    toolRegistry: any;
+    policyEngine?: any;
+    contextProvider?: ExternalContextProviderAdapter;
+    stream?: DefaultStreamSink;
+    allowedTools?: string[];
+    engine?: ExecutionEngine;
+}
+export declare function createDemoFramework(opts: DemoFrameworkOptions): {
+    framework: any;
+};
+//# sourceMappingURL=framework.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/framework.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAEjB,8BAA8B,EAC9B,KAAK,kBAAkB,EAIxB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAgB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,eAAe,CAAC,EAAE,8BAA8B,CAAC;IACjD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB;;EAiD7D"}

package/dist/src/framework.js

@@ -0,0 +1,42 @@
+import { DeterministicNucleus, } from '@acm/sdk';
+import { createOllamaClient, createVLLMClient } from '@acm/llm';
+import { ACMFramework, ExecutionEngine } from '@acm/framework';
+export function createDemoFramework(opts) {
+    const provider = opts.provider ?? 'ollama';
+    const model = opts.model ?? 'llama3.1';
+    const llm = provider === 'ollama' ? createOllamaClient(model, opts.baseUrl) : createVLLMClient(model, opts.baseUrl);
+    if (!llm.generateWithTools) {
+        throw new Error('Selected LLM provider does not support structured tool calls required by Nucleus.');
+    }
+    let activeLedger;
+    const nucleusCall = async (prompt, tools, callConfig) => {
+        const toolDefs = tools.map(tool => ({
+            name: tool.name,
+            description: tool.description ?? 'Nucleus tool',
+            inputSchema: tool.inputSchema ?? { type: 'object', properties: {} },
+        }));
+        const response = await llm.generateWithTools([{ role: 'system', content: prompt }], toolDefs, { temperature: callConfig.temperature, seed: callConfig.seed, maxTokens: callConfig.maxTokens });
+        return {
+            reasoning: response.text,
+            toolCalls: (response.toolCalls ?? []).map(tc => ({ id: tc.id, name: tc.name, input: tc.arguments })),
+            raw: response.raw,
+        };
+    };
+    const framework = ACMFramework.create({
+        capabilityRegistry: opts.capabilityRegistry,
+        toolRegistry: opts.toolRegistry,
+        policyEngine: opts.policyEngine,
+        contextProvider: opts.contextProvider,
+        defaultStream: opts.stream,
+        nucleus: {
+            call: nucleusCall,
+            llmConfig: { provider: llm.name(), model, temperature: 0.1, maxTokens: 512 },
+            hooks: { preflight: true, postcheck: true },
+            allowedTools: opts.allowedTools,
+            factory: (ledger) => (config) => new DeterministicNucleus(config, nucleusCall, (entry) => ledger.append(entry.type, entry.details)),
+        },
+        execution: { engine: opts.engine ?? ExecutionEngine.ACM },
+    });
+    return { framework };
+}
+//# sourceMappingURL=framework.js.map

package/dist/src/framework.js.map

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

package/dist/src/registries.d.ts

@@ -14,5 +14,8 @@ export declare class SimpleToolRegistry extends ToolRegistry {
     register(tool: Tool): void;
     get(name: string): Tool | undefined;
     list(): string[];
+    has(name: string): boolean;
+    getSpec(name: string): import("@ddse/acm-sdk").ToolSpec | undefined;
+    listSpecs(): import("@ddse/acm-sdk").ToolSpec[];
 }
 //# sourceMappingURL=registries.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../../src/registries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAExG,qBAAa,wBAAyB,SAAQ,kBAAkB;IAC9D,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAiC;IAErD,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAKlD,IAAI,IAAI,UAAU,EAAE;IAIpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI9C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAGhD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,KAAK,CAA2B;IAExC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,IAAI,IAAI,MAAM,EAAE;CAGjB"}
+{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../../src/registries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAExG,qBAAa,wBAAyB,SAAQ,kBAAkB;IAC9D,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAiC;IAErD,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAKlD,IAAI,IAAI,UAAU,EAAE;IAIpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI9C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAGhD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,KAAK,CAA2B;IAExC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,IAAI,IAAI,MAAM,EAAE;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,OAAO,CAAC,IAAI,EAAE,MAAM;IAIpB,SAAS;CAKV"}

package/dist/src/registries.js

@@ -34,5 +34,16 @@ export class SimpleToolRegistry extends ToolRegistry {
     list() {
         return Array.from(this.tools.keys());
     }
+    has(name) {
+        return this.tools.has(name);
+    }
+    getSpec(name) {
+        return this.tools.get(name)?.spec;
+    }
+    listSpecs() {
+        return Array.from(this.tools.values())
+            .map(t => t.spec)
+            .filter((s) => s != null);
+    }
 }
 //# sourceMappingURL=registries.js.map

package/dist/src/registries.js.map

@@ -1 +1 @@
-{"version":3,"file":"registries.js","sourceRoot":"","sources":["../../src/registries.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAyC,MAAM,eAAe,CAAC;AAExG,MAAM,OAAO,wBAAyB,SAAQ,kBAAkB;IACtD,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAChC,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,QAAQ,CAAC,UAAsB,EAAE,IAAU;QACzC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAClD,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAC1C,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAExC,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"registries.js","sourceRoot":"","sources":["../../src/registries.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAyC,MAAM,eAAe,CAAC;AAExG,MAAM,OAAO,wBAAyB,SAAQ,kBAAkB;IACtD,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAChC,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,QAAQ,CAAC,UAAsB,EAAE,IAAU;QACzC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAClD,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAC1C,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAExC,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACpC,CAAC;IAED,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aACnC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/tests/entitlement.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entitlement.test.d.ts.map

package/dist/tests/entitlement.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement.test.d.ts","sourceRoot":"","sources":["../../tests/entitlement.test.ts"],"names":[],"mappings":""}

package/dist/tests/entitlement.test.js

@@ -0,0 +1,30 @@
+import { MemoryLedger } from '@acm/runtime';
+import { DefaultStreamSink } from '@acm/sdk';
+import { SimpleCapabilityRegistry, SimpleToolRegistry } from '../src/registries.js';
+import { createDemoFramework } from '../src/framework.js';
+import { goals, contexts } from '../src/goals/index.js';
+import { FetchCustomerProfileTask, EvaluateEntitlementTask, NotifySupervisorTask } from '../src/examples/entitlement/tasks.js';
+import { FetchCustomerProfileTool, EvaluateEntitlementTool, NotifySupervisorTool } from '../src/examples/entitlement/tools.js';
+async function run() {
+    const capabilityRegistry = new SimpleCapabilityRegistry();
+    capabilityRegistry.register({ name: 'fetch_customer_profile', sideEffects: false }, new FetchCustomerProfileTask());
+    capabilityRegistry.register({ name: 'evaluate_entitlement', sideEffects: false }, new EvaluateEntitlementTask());
+    capabilityRegistry.register({ name: 'notify_supervisor', sideEffects: false }, new NotifySupervisorTask());
+    const toolRegistry = new SimpleToolRegistry();
+    toolRegistry.register(new FetchCustomerProfileTool());
+    toolRegistry.register(new EvaluateEntitlementTool());
+    toolRegistry.register(new NotifySupervisorTool());
+    const { framework } = createDemoFramework({ capabilityRegistry, toolRegistry, stream: new DefaultStreamSink() });
+    const planned = await framework.plan({ goal: goals.entitlement, context: contexts.entitlement });
+    const exec = await framework.execute({ goal: planned.goal, context: planned.context, existingPlan: { plan: planned.selectedPlan, plannerResult: planned.result }, ledger: new MemoryLedger() });
+    const outputs = exec.execution.outputsByTask;
+    const keys = Object.keys(outputs);
+    if (!keys.length)
+        throw new Error('No task outputs');
+    console.log('Tasks executed:', keys);
+    return true;
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    run().then(() => process.exit(0)).catch(err => { console.error(err); process.exit(1); });
+}
+//# sourceMappingURL=entitlement.test.js.map

package/dist/tests/entitlement.test.js.map

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