@jangts/agent-core 0.3.6 → 0.5.0

package/dist/cjs/execution/index.js

@@ -1,30 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationError = exports.BudgetError = void 0;
-/**
- * Public surface of the execution layer.
- *
- * Re-exports the engine, the workflow catalog and its route helpers, the shared budget
- * and validation errors, and the policy kit. Applications should import the loop and
- * workflow contracts from here rather than from individual files.
- */
-__exportStar(require("./engine.js"), exports);
-__exportStar(require("./workflow.js"), exports);
-var errors_js_1 = require("../structs/errors.js");
-Object.defineProperty(exports, "BudgetError", { enumerable: true, get: function () { return errors_js_1.BudgetError; } });
-Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
-__exportStar(require("../kits/policies.js"), exports);

package/dist/cjs/kits/intents/catalog.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineAgentCatalog = defineAgentCatalog;
-/**
- * Intents Kit: project registered intents, scopes and tools into one task-facing catalog.
- *
- * Place in the package: part of the `intents` Kit. It reads the actual registries supplied by
- * the App instead of maintaining a parallel capability list, so an intent is only advertised
- * when its tools, scopes and availability agree.
- *
- * Exports: `defineAgentCatalog`, and the catalog intent/scope/port types.
- */
-const synchronous_js_1 = require("../../utils/synchronous.js");
-/**
- * Compile a catalog projection over the App's live registries.
- *
- * The actual registries determine availability and relationships. No parallel capability list
- * exists: `intentIds` filters by tool support, `modelCatalog` narrows to the currently accepted
- * task when `restrictToTask` is enabled, and scope tool ids are filtered to tools that exist.
- *
- * @param ports - Sources for intent ids, intents, scopes, the current task, the tool registry
- *   and the `restrictToTask` switch.
- * @returns A frozen projection with `intentIds`, `intentSteps`, `intentCatalog`,
- *   `scopeCatalog` and `modelCatalog`.
- * @throws TypeError When a supplied predicate does not return a boolean synchronously.
- */
-function defineAgentCatalog(ports) {
-    const ids = ports.intentIds.bind(ports), intents = ports.intents.bind(ports), scopes = ports.scopes.bind(ports), task = ports.currentTask.bind(ports);
-    const tools = {
-        values: ports.tools.values.bind(ports.tools),
-        has: ports.tools.has.bind(ports.tools),
-        supports: ports.tools.supportsIntent.bind(ports.tools),
-        describe: ports.tools.describe.bind(ports.tools),
-    };
-    const restrict = ports.restrictToTask !== false;
-    const boolean = (value) => (0, synchronous_js_1.booleanResult)(value, 'Catalog predicates must be synchronous', 'Catalog predicates must return boolean');
-    const intentIds = (app) => ids().filter((id) => boolean(tools.supports(id, app)));
-    const intentSteps = (app) => new Map(intents().map((intent) => [
-        intent.id,
-        [
-            ...new Set([
-                ...intent.steps,
-                ...[...tools.values()]
-                    .filter((tool) => tool.invocation &&
-                    (!tool.available || app === undefined || boolean(tool.available(app))) &&
-                    (tool.intentIds === 'all' || tool.intentIds.includes(intent.id)))
-                    .map((tool) => tool.invocation.step),
-            ]),
-        ],
-    ]));
-    const intentCatalog = (app) => {
-        const selected = intentIds(app), described = tools.describe('model', app), steps = intentSteps(app);
-        return intents(selected).map((intent) => ({
-            ...intent,
-            steps: steps.get(intent.id) ?? [...intent.steps],
-            scopeIds: scopes([intent.id]).map((scope) => scope.id),
-            toolIds: described
-                .filter((tool) => tool.intentIds.includes(intent.id))
-                .map((tool) => tool.id),
-        }));
-    };
-    const scopeCatalog = (app) => scopes(intentIds(app)).map((scope) => ({ ...scope, toolIds: scope.toolIds.filter(tools.has) }));
-    return Object.freeze({
-        intentIds,
-        intentSteps,
-        intentCatalog,
-        scopeCatalog,
-        modelCatalog(app) {
-            const accepted = restrict ? task(app) : undefined, selected = intentIds(app).filter((id) => !accepted || id === accepted.intentId);
-            return {
-                availableIntentIds: selected,
-                availableIntents: intentCatalog(app)
-                    .filter((intent) => selected.includes(intent.id))
-                    .map((intent) => accepted ? { ...intent, scopeIds: accepted.scopeId ? [accepted.scopeId] : [] } : intent),
-                availableScopes: scopeCatalog(app).filter((scope) => !accepted || scope.id === accepted.scopeId),
-                availableTools: tools
-                    .describe('model', app)
-                    .filter((tool) => !accepted || tool.intentIds.includes(accepted.intentId)),
-            };
-        },
-    });
-}

package/dist/cjs/kits/intents/index.js

@@ -1,35 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Intents = void 0;
-/**
- * Intents Kit entry: intent and scope registries plus the task-facing catalog projection.
- *
- * Place in the package: an optional App-side library for declaring what the agent may do.
- * Applications register their own intents and scopes; this directory owns registration
- * checks, aliases, relationship lookups and the model-visible projection. Core never imports it.
- *
- * Exports: everything from `./registry.js`, `./scopes.js` and `./catalog.js`, plus the
- * `Intents` namespace object.
- */
-__exportStar(require("./registry.js"), exports);
-__exportStar(require("./scopes.js"), exports);
-__exportStar(require("./catalog.js"), exports);
-const registry_js_1 = require("./registry.js");
-const scopes_js_1 = require("./scopes.js");
-const catalog_js_1 = require("./catalog.js");
-/** Namespace object for callers that prefer one import over named helpers. */
-exports.Intents = Object.freeze({ IntentRegistry: registry_js_1.IntentRegistry, ScopeRegistry: scopes_js_1.ScopeRegistry, defineAgentCatalog: catalog_js_1.defineAgentCatalog });

package/dist/esm/execution/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Public surface of the execution layer.
- *
- * Re-exports the engine, the workflow catalog and its route helpers, the shared budget
- * and validation errors, and the policy kit. Applications should import the loop and
- * workflow contracts from here rather than from individual files.
- */
-export * from './engine.js';
-export * from './workflow.js';
-export { BudgetError, ValidationError } from '../structs/errors.js';
-export * from '../kits/policies.js';

package/dist/esm/execution/index.js

@@ -1,11 +0,0 @@
-/**
- * Public surface of the execution layer.
- *
- * Re-exports the engine, the workflow catalog and its route helpers, the shared budget
- * and validation errors, and the policy kit. Applications should import the loop and
- * workflow contracts from here rather than from individual files.
- */
-export * from './engine.js';
-export * from './workflow.js';
-export { BudgetError, ValidationError } from '../structs/errors.js';
-export * from '../kits/policies.js';

package/dist/esm/kits/intents/catalog.d.ts

@@ -1,39 +0,0 @@
-import type { AgentCatalogPorts, CatalogIntent, CatalogScope } from '../../structs/kits/intents/catalog.js';
-/**
- * Compile a catalog projection over the App's live registries.
- *
- * The actual registries determine availability and relationships. No parallel capability list
- * exists: `intentIds` filters by tool support, `modelCatalog` narrows to the currently accepted
- * task when `restrictToTask` is enabled, and scope tool ids are filtered to tools that exist.
- *
- * @param ports - Sources for intent ids, intents, scopes, the current task, the tool registry
- *   and the `restrictToTask` switch.
- * @returns A frozen projection with `intentIds`, `intentSteps`, `intentCatalog`,
- *   `scopeCatalog` and `modelCatalog`.
- * @throws TypeError When a supplied predicate does not return a boolean synchronously.
- */
-export declare function defineAgentCatalog<App, Id extends string, Intent extends CatalogIntent<Id>, Scope extends CatalogScope>(ports: AgentCatalogPorts<App, Id, Intent, Scope>): Readonly<{
-    intentIds: (app: App) => Id[];
-    intentSteps: (app?: App) => Map<Id, string[]>;
-    intentCatalog: (app: App) => (Intent & {
-        steps: string[];
-        scopeIds: string[];
-        toolIds: string[];
-    })[];
-    scopeCatalog: (app: App) => (Scope & {
-        toolIds: string[];
-    })[];
-    modelCatalog(app: App): {
-        availableIntentIds: Id[];
-        availableIntents: (Intent & {
-            steps: string[];
-            scopeIds: string[];
-            toolIds: string[];
-        })[];
-        availableScopes: (Scope & {
-            toolIds: string[];
-        })[];
-        availableTools: import("./catalog.js").DescribedTool[];
-    };
-}>;
-export type * from '../../structs/kits/intents/catalog.js';

package/dist/esm/kits/intents/catalog.js

@@ -1,79 +0,0 @@
-/**
- * Intents Kit: project registered intents, scopes and tools into one task-facing catalog.
- *
- * Place in the package: part of the `intents` Kit. It reads the actual registries supplied by
- * the App instead of maintaining a parallel capability list, so an intent is only advertised
- * when its tools, scopes and availability agree.
- *
- * Exports: `defineAgentCatalog`, and the catalog intent/scope/port types.
- */
-import { booleanResult } from '../../utils/synchronous.js';
-/**
- * Compile a catalog projection over the App's live registries.
- *
- * The actual registries determine availability and relationships. No parallel capability list
- * exists: `intentIds` filters by tool support, `modelCatalog` narrows to the currently accepted
- * task when `restrictToTask` is enabled, and scope tool ids are filtered to tools that exist.
- *
- * @param ports - Sources for intent ids, intents, scopes, the current task, the tool registry
- *   and the `restrictToTask` switch.
- * @returns A frozen projection with `intentIds`, `intentSteps`, `intentCatalog`,
- *   `scopeCatalog` and `modelCatalog`.
- * @throws TypeError When a supplied predicate does not return a boolean synchronously.
- */
-export function defineAgentCatalog(ports) {
-    const ids = ports.intentIds.bind(ports), intents = ports.intents.bind(ports), scopes = ports.scopes.bind(ports), task = ports.currentTask.bind(ports);
-    const tools = {
-        values: ports.tools.values.bind(ports.tools),
-        has: ports.tools.has.bind(ports.tools),
-        supports: ports.tools.supportsIntent.bind(ports.tools),
-        describe: ports.tools.describe.bind(ports.tools),
-    };
-    const restrict = ports.restrictToTask !== false;
-    const boolean = (value) => booleanResult(value, 'Catalog predicates must be synchronous', 'Catalog predicates must return boolean');
-    const intentIds = (app) => ids().filter((id) => boolean(tools.supports(id, app)));
-    const intentSteps = (app) => new Map(intents().map((intent) => [
-        intent.id,
-        [
-            ...new Set([
-                ...intent.steps,
-                ...[...tools.values()]
-                    .filter((tool) => tool.invocation &&
-                    (!tool.available || app === undefined || boolean(tool.available(app))) &&
-                    (tool.intentIds === 'all' || tool.intentIds.includes(intent.id)))
-                    .map((tool) => tool.invocation.step),
-            ]),
-        ],
-    ]));
-    const intentCatalog = (app) => {
-        const selected = intentIds(app), described = tools.describe('model', app), steps = intentSteps(app);
-        return intents(selected).map((intent) => ({
-            ...intent,
-            steps: steps.get(intent.id) ?? [...intent.steps],
-            scopeIds: scopes([intent.id]).map((scope) => scope.id),
-            toolIds: described
-                .filter((tool) => tool.intentIds.includes(intent.id))
-                .map((tool) => tool.id),
-        }));
-    };
-    const scopeCatalog = (app) => scopes(intentIds(app)).map((scope) => ({ ...scope, toolIds: scope.toolIds.filter(tools.has) }));
-    return Object.freeze({
-        intentIds,
-        intentSteps,
-        intentCatalog,
-        scopeCatalog,
-        modelCatalog(app) {
-            const accepted = restrict ? task(app) : undefined, selected = intentIds(app).filter((id) => !accepted || id === accepted.intentId);
-            return {
-                availableIntentIds: selected,
-                availableIntents: intentCatalog(app)
-                    .filter((intent) => selected.includes(intent.id))
-                    .map((intent) => accepted ? { ...intent, scopeIds: accepted.scopeId ? [accepted.scopeId] : [] } : intent),
-                availableScopes: scopeCatalog(app).filter((scope) => !accepted || scope.id === accepted.scopeId),
-                availableTools: tools
-                    .describe('model', app)
-                    .filter((tool) => !accepted || tool.intentIds.includes(accepted.intentId)),
-            };
-        },
-    });
-}

package/dist/esm/kits/intents/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * Intents Kit entry: intent and scope registries plus the task-facing catalog projection.
- *
- * Place in the package: an optional App-side library for declaring what the agent may do.
- * Applications register their own intents and scopes; this directory owns registration
- * checks, aliases, relationship lookups and the model-visible projection. Core never imports it.
- *
- * Exports: everything from `./registry.js`, `./scopes.js` and `./catalog.js`, plus the
- * `Intents` namespace object.
- */
-export * from './registry.js';
-export * from './scopes.js';
-export * from './catalog.js';
-import { IntentRegistry } from './registry.js';
-import { ScopeRegistry } from './scopes.js';
-import { defineAgentCatalog } from './catalog.js';
-/** Namespace object for callers that prefer one import over named helpers. */
-export declare const Intents: Readonly<{
-    IntentRegistry: typeof IntentRegistry;
-    ScopeRegistry: typeof ScopeRegistry;
-    defineAgentCatalog: typeof defineAgentCatalog;
-}>;

package/dist/esm/kits/intents/index.js

@@ -1,18 +0,0 @@
-/**
- * Intents Kit entry: intent and scope registries plus the task-facing catalog projection.
- *
- * Place in the package: an optional App-side library for declaring what the agent may do.
- * Applications register their own intents and scopes; this directory owns registration
- * checks, aliases, relationship lookups and the model-visible projection. Core never imports it.
- *
- * Exports: everything from `./registry.js`, `./scopes.js` and `./catalog.js`, plus the
- * `Intents` namespace object.
- */
-export * from './registry.js';
-export * from './scopes.js';
-export * from './catalog.js';
-import { IntentRegistry } from './registry.js';
-import { ScopeRegistry } from './scopes.js';
-import { defineAgentCatalog } from './catalog.js';
-/** Namespace object for callers that prefer one import over named helpers. */
-export const Intents = Object.freeze({ IntentRegistry, ScopeRegistry, defineAgentCatalog });

package/dist/esm/kits/intents/registry.d.ts

@@ -1,88 +0,0 @@
-/**
- * Intents Kit: an ordered, sealable registry of intent declarations.
- *
- * Place in the package: part of the `intents` Kit. Intent semantics and the allowed vocabulary
- * (scope modes, target modes, context tiers, steps, actions) are App configuration; this class
- * owns the common lifecycle — validation, ordering, duplicate detection and sealing.
- *
- * Exports: `IntentRegistry`, `createIntentRegistry`, and the intent registry types.
- */
-import type { IntentDefinition, IntentDescription, IntentRegistryPolicy, IntentId, RegisteredIntent } from '../../structs/kits/intents/registry.js';
-/**
- * Intent semantics and allowed values are configuration; the registry owns their common lifecycle.
- *
- * Registration order is preserved by `ids`, `definitions`, `values` and `entries`; once
- * `seal()` is called the set is final and further registration is rejected.
- */
-export declare class IntentRegistry<Definition extends IntentDefinition = IntentDefinition> {
-    /** Create and seal a complete catalog in one call. */
-    static readonly create: typeof createIntentRegistry;
-    private readonly byId;
-    private sealed;
-    private readonly policy;
-    /**
-     * @param policy - Optional id pattern, vocabulary lists, error wording and assertion hook.
-     *   Lists and the pattern are copied so later mutation of the input cannot weaken checks.
-     */
-    constructor(policy?: IntentRegistryPolicy<Definition>);
-    /**
-     * Validate, freeze and add one intent.
-     *
-     * Checks run in a fixed order — sealed, identity, context contract, auxiliary actions,
-     * handoff, plan, steps — so the reported violation is stable when several rules fail.
-     *
-     * @param input - Intent declaration; the App's own assertion receives this original object,
-     *   not the compiled copy, so helpers and prototype methods keep working.
-     * @returns This registry, for chaining.
-     * @throws A configured error for a sealed registry, invalid identity or vocabulary values,
-     *   empty/duplicate steps, or a duplicate intent id.
-     */
-    register(input: Definition): this;
-    /** Register every intent in iteration order. */
-    registerAll(definitions: Iterable<Definition>): this;
-    /** Registered intent for `goal`, or `undefined` when it is absent. */
-    get(goal: string): RegisteredIntent<Definition> | undefined;
-    /** Whether an intent id is registered. */
-    has(goal: string): boolean;
-    /** Registered intent ids in registration order. */
-    ids(): readonly IntentId<Definition>[];
-    /** Registered intents in registration order. */
-    get definitions(): readonly RegisteredIntent<Definition>[];
-    /** Iterate the registered intents. */
-    values(): MapIterator<Readonly<Omit<Readonly<IntentDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof IntentDefinition>>>, "steps" | "auxiliaryActions"> & { readonly [Key in keyof Pick<Definition, Extract<keyof Definition, "steps" | "auxiliaryActions">>]: Readonly<Definition[Key]>; } & {
-        id: Definition["id"];
-        steps: Readonly<Definition["steps"]>;
-    }>>;
-    /** Iterate `[id, intent]` pairs. */
-    entries(): MapIterator<[string, Readonly<Omit<Readonly<IntentDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof IntentDefinition>>>, "steps" | "auxiliaryActions"> & { readonly [Key in keyof Pick<Definition, Extract<keyof Definition, "steps" | "auxiliaryActions">>]: Readonly<Definition[Key]>; } & {
-        id: Definition["id"];
-        steps: Readonly<Definition["steps"]>;
-    }>]>;
-    /**
-     * Registered intent for `id`.
-     *
-     * @throws TypeError When the id is not registered.
-     */
-    require(id: string): RegisteredIntent<Definition>;
-    /** Whether the intent declares this step; unknown intents allow nothing. */
-    allows(goal: string, step: string): boolean;
-    /**
-     * Copy the selected intents out of the registry.
-     *
-     * @param goals - Ids to include; the default is every registered id, in registry order.
-     * @returns Descriptions whose arrays are copied so callers cannot mutate registry state.
-     */
-    describe(goals?: readonly string[]): IntentDescription<Definition>[];
-    /** Finalize the registry; no registration is accepted afterwards. */
-    seal(): this;
-}
-/**
- * Create and seal a complete catalog; use the constructor for incremental installation.
- *
- * @param definitions - Intent declarations registered in iteration order.
- * @param policy - Optional registry policy forwarded to the constructor.
- * @returns A sealed registry.
- * @throws A configured error for the first invalid or duplicate declaration.
- */
-export declare function createIntentRegistry<Definition extends IntentDefinition>(definitions: Iterable<Definition>, policy?: IntentRegistryPolicy<Definition>): IntentRegistry<Definition>;
-export type { IntentDefinition, IntentDescription, IntentRegistryPolicy, IntentId, RegisteredIntent, } from '../../structs/kits/intents/registry.js';