@aisy/core 0.1.0

package/dist/provider/index.js

@@ -0,0 +1,236 @@
+import { createHash } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Fixed routing policy (ADR-0018)
+// ---------------------------------------------------------------------------
+const TABLE = {
+    reasoning: { family: 'deepseek', model: 'deepseek-v4-pro' },
+    critique: { family: 'anthropic', model: 'claude-opus-4.8' },
+    routine: { family: 'deepseek', model: 'deepseek-v4-flash' },
+};
+/** Fallback fires when consecutiveErrors reaches exactly this (ADR-0018). */
+const HYSTERESIS_THRESHOLD = 2;
+/** Frozen cache-breakpoint layout (ADR-0019). */
+const MAX_CACHE_BREAKPOINTS = 4;
+const keyOf = (p) => `${p.family}:${p.model}`;
+const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
+const classifyRole = (req) => {
+    switch (req.role) {
+        case 'generator': return 'reasoning';
+        case 'judge': return 'critique';
+        case 'agent':
+        case 'classifier': return 'routine';
+        default:
+            throw new Error(`classify: unknown role '${String(req.role)}'`);
+    }
+};
+// ---------------------------------------------------------------------------
+// makeModelRouter
+// ---------------------------------------------------------------------------
+export function makeModelRouter(deps) {
+    const adapters = new Map(deps.adapters.map(a => [keyOf(a.providerId), a]));
+    const hysteresis = deps.hysteresisStore ?? new Map();
+    const budgets = deps.budgets ?? new Map();
+    const queueStore = deps.queueStore ?? new Map();
+    const reviewQueue = deps.reviewQueue ?? new Map();
+    /** Per-task session-start prefix hash — the stable-prefix contract (ADR-0019). */
+    const prefixHashes = new Map();
+    const emit = (event) => { deps.emitEvent?.(event); };
+    const errorCount = (p) => hysteresis.get(keyOf(p))?.consecutiveErrors ?? 0;
+    const isDown = (p) => errorCount(p) >= HYSTERESIS_THRESHOLD;
+    const recordError = (p) => {
+        const next = errorCount(p) + 1;
+        hysteresis.set(keyOf(p), { provider: p, consecutiveErrors: next });
+        return next;
+    };
+    const recordSuccess = (p) => {
+        hysteresis.set(keyOf(p), { provider: p, consecutiveErrors: 0 });
+    };
+    /** Escalation order for a tier: the table default first, then the policy order. */
+    const orderFor = (tier) => {
+        const rest = deps.escalationOrder ?? deps.adapters.map(a => a.providerId);
+        const ordered = [TABLE[tier], ...rest];
+        const seen = new Set();
+        return ordered.filter(p => {
+            const k = keyOf(p);
+            if (seen.has(k) || !adapters.has(k))
+                return false;
+            seen.add(k);
+            return true;
+        });
+    };
+    /** First not-down provider in escalation order; null when all are down. */
+    const resolveProvider = (tier) => orderFor(tier).find(p => !isDown(p)) ?? null;
+    const classifySafe = (req) => {
+        try {
+            return classifyRole(req);
+        }
+        catch {
+            // Fail SAFE: an unclassifiable request gets the critique tier — never a
+            // weaker one (spec 09, Eng). Surface the safe-default classification with
+            // the fallback flag so Observability sees the downgrade-avoidance (spec
+            // 09 §7 "Classifier call fails or times out" → route.classified(fallback=true)).
+            const tier = 'critique';
+            emit({ type: 'route.classified', taskId: req.taskId, tier, fallback: true });
+            return tier;
+        }
+    };
+    // Serialize the WHOLE request so the queued record is replayable — body.raw
+    // alone drops role, the stable prefix, the token estimate, and the paired
+    // generator, none of which can be reconstructed on resume (spec 09 §4, Eng-7).
+    const serializeRequest = (req) => {
+        const payload = {
+            taskId: req.taskId,
+            requestId: req.requestId,
+            role: req.role,
+            stablePrefix: Array.from(req.stablePrefix),
+            body: {
+                raw: Array.from(req.body.raw),
+                estimatedInputTokens: req.body.estimatedInputTokens,
+            },
+            ...(req.pairedGeneratorProvider ? { pairedGeneratorProvider: req.pairedGeneratorProvider } : {}),
+        };
+        return new TextEncoder().encode(JSON.stringify(payload));
+    };
+    const allDown = (req) => {
+        queueStore.set(req.requestId, {
+            taskId: req.taskId,
+            requestId: req.requestId,
+            serializedRequest: serializeRequest(req),
+            queuedAt: Date.now(),
+        });
+        emit({ type: 'route.all_down_queued', taskId: req.taskId, requestId: req.requestId });
+        return { kind: 'all_providers_down', queuedRequestId: req.requestId };
+    };
+    return {
+        async classify(req) {
+            const tier = classifyRole(req);
+            emit({ type: 'route.classified', taskId: req.taskId, tier, fallback: false });
+            return tier;
+        },
+        // Route is code-only: nothing inside body.raw can influence the decision —
+        // the router never inspects the opaque request body (spec 09 §2).
+        async route(req) {
+            const tier = classifySafe(req);
+            // Fail closed when every provider is down — never hand back a known-down
+            // provider as a non-error decision (spec 09 §3/§7, Eng-7 terminal policy).
+            const provider = resolveProvider(tier);
+            if (!provider)
+                return allDown(req);
+            const decision = {
+                provider,
+                tier,
+                fromFallback: keyOf(provider) !== keyOf(TABLE[tier]),
+                cacheBreakpoints: MAX_CACHE_BREAKPOINTS,
+            };
+            emit({ type: 'route.resolved', taskId: req.taskId, decision });
+            return decision;
+        },
+        async dispatch(req) {
+            // Cold-start guard: refuse until the routing table / price sheet loads.
+            if (deps.ready === false)
+                return { kind: 'router_not_ready' };
+            // Stable-prefix contract (ADR-0019): the prefix is byte-stable per task;
+            // a mutated prefix is refused before any adapter call.
+            const actualHash = sha256(req.stablePrefix);
+            const expectedHash = prefixHashes.get(req.taskId);
+            if (expectedHash === undefined) {
+                prefixHashes.set(req.taskId, actualHash);
+            }
+            else if (expectedHash !== actualHash) {
+                emit({ type: 'cache.prefix_mismatch', taskId: req.taskId, expectedHash, actualHash });
+                return { kind: 'prefix_mutated', expectedHash, actualHash };
+            }
+            const tier = classifySafe(req);
+            let provider = resolveProvider(tier);
+            if (!provider)
+                return allDown(req);
+            // Judge-independence (Eng): the RUN-TIME resolved provider (including
+            // after fallback) must differ in family from the paired generator. The
+            // check runs both before the call AND after any within-loop fallback,
+            // because a fallback can land the judge on the generator's family
+            // (spec 09 §5 step 4 — "after the provider is resolved … including any
+            // fallback").
+            const judgeCollision = (p) => {
+                if (req.role === 'judge' && req.pairedGeneratorProvider &&
+                    p.family === req.pairedGeneratorProvider.family) {
+                    reviewQueue.set(req.requestId, req);
+                    emit({ type: 'judge.collision_held', taskId: req.taskId, candidateId: req.requestId });
+                    return { kind: 'judge_collision_held', candidateId: req.requestId };
+                }
+                return null;
+            };
+            const preCollision = judgeCollision(provider);
+            if (preCollision)
+                return preCollision;
+            // Budget ceiling enforced in code BEFORE dispatch (Eng-12).
+            const budget = budgets.get(req.taskId);
+            if (budget) {
+                // Both ceilings guard the SAME thing — the PROJECTED (post-call) total
+                // — so a call that *would* cross either ceiling is refused before it
+                // runs (spec 09 §4). The dollar side has no per-call dollar estimate, so
+                // it projects this call's cost from the realized rate ($/token so far)
+                // applied to the estimated input tokens, mirroring the token check.
+                const projectedTokens = budget.tokensSpent + req.body.estimatedInputTokens;
+                const pricePerToken = budget.tokensSpent > 0 ? budget.dollarsSpent / budget.tokensSpent : 0;
+                const projectedDollars = budget.dollarsSpent + req.body.estimatedInputTokens * pricePerToken;
+                if (projectedTokens > budget.tokenCeiling || projectedDollars > budget.dollarCeiling) {
+                    emit({ type: 'budget.exceeded', taskId: req.taskId, budget });
+                    return { kind: 'budget_exceeded', budget };
+                }
+            }
+            // Single attempt per dispatch; the second consecutive error marks the
+            // provider down and escalates within this dispatch (hysteresis, ADR-0018).
+            for (;;) {
+                const adapter = adapters.get(keyOf(provider));
+                try {
+                    const result = await adapter.call(req);
+                    recordSuccess(provider);
+                    // Cost telemetry (ADR-0036): on EVERY successful dispatch, emit the
+                    // per-call charge for the RESOLVED provider (after any fallback) —
+                    // independent of whether a TaskBudget is configured (spec 09 §5,
+                    // AC-09-19).
+                    emit({
+                        type: 'provider.cost.charged',
+                        taskId: req.taskId,
+                        requestId: req.requestId,
+                        tier,
+                        tokens: result.inputTokens + result.outputTokens,
+                        dollars: result.dollarsCharged,
+                    });
+                    if (budget) {
+                        budget.tokensSpent += result.inputTokens + result.outputTokens;
+                        budget.dollarsSpent += result.dollarsCharged;
+                        emit({
+                            type: 'budget.charged',
+                            taskId: req.taskId,
+                            requestId: req.requestId,
+                            dollars: result.dollarsCharged,
+                            tokens: result.inputTokens + result.outputTokens,
+                        });
+                    }
+                    return result;
+                }
+                catch (err) {
+                    const errorKind = (err.kind ?? 'server-error');
+                    const count = recordError(provider);
+                    if (count < HYSTERESIS_THRESHOLD) {
+                        // A single transient error never flips the route.
+                        return { kind: 'provider_error', providerId: provider, errorKind };
+                    }
+                    // Provider is down — escalate to the next available one.
+                    const next = resolveProvider(tier);
+                    if (!next)
+                        return allDown(req);
+                    emit({ type: 'route.fallback', taskId: req.taskId, from: provider, to: next });
+                    provider = next;
+                    // Re-run the run-time independence guard: the fallback may have landed
+                    // the judge on the generator's family — hold instead of self-judging.
+                    const postCollision = judgeCollision(provider);
+                    if (postCollision)
+                        return postCollision;
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/provider/index.js.map

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

package/dist/provider/types.d.ts

@@ -0,0 +1,180 @@
+export type RouteTier = "reasoning" | "critique" | "routine";
+export type ProviderFamily = "deepseek" | "anthropic" | "openai";
+export type ProviderErrorKind = "rate-limit" | "server-error" | "timeout";
+export interface ProviderId {
+    family: ProviderFamily;
+    model: string;
+}
+/** Opaque append-only conversation tail + tool definitions authored by Core. */
+export interface RequestBody {
+    /** Serialised conversation tail; router must not inspect or mutate. */
+    raw: Uint8Array;
+    /** Estimated input token count for budget pre-check. */
+    estimatedInputTokens: number;
+}
+/**
+ * A request handed in by Core (01) or Nightly (10).
+ * The prefix is already byte-stable; the router MUST NOT mutate it (ADR-0019).
+ */
+export interface ModelRequest {
+    taskId: string;
+    requestId: string;
+    role: "classifier" | "generator" | "judge" | "agent";
+    /** Byte-stable; cache-breakpoint layout is frozen by Core (ADR-0019). */
+    stablePrefix: Uint8Array;
+    body: RequestBody;
+    /** For judge calls: the provider actually used for the paired generator artifact. */
+    pairedGeneratorProvider?: ProviderId;
+}
+export interface ModelResult {
+    requestId: string;
+    provider: ProviderId;
+    content: string;
+    inputTokens: number;
+    outputTokens: number;
+    /** Actual dollar cost charged, computed from the resolved provider's price sheet. */
+    dollarsCharged: number;
+}
+export interface RouteDecision {
+    provider: ProviderId;
+    tier: RouteTier;
+    /** true if hysteresis escalated off the default provider (ADR-0018). */
+    fromFallback: boolean;
+    /** 0..4 cache breakpoints placed in the dispatched request (ADR-0019). */
+    cacheBreakpoints: number;
+}
+/**
+ * Per-provider error counter for the current session.
+ * Increments on 429 / 5xx / timeout; resets to 0 on any success.
+ * Fallback fires when consecutiveErrors reaches exactly 2.
+ */
+export interface HysteresisState {
+    provider: ProviderId;
+    consecutiveErrors: number;
+}
+/** Per-task token and dollar ceilings enforced in code across all calls. */
+export interface TaskBudget {
+    taskId: string;
+    tokenCeiling: number;
+    dollarCeiling: number;
+    tokensSpent: number;
+    dollarsSpent: number;
+}
+export interface QueueRecord {
+    taskId: string;
+    requestId: string;
+    serializedRequest: Uint8Array;
+    queuedAt: number;
+}
+/** Session-start hash of the stable prefix used on every dispatch assertion. */
+export interface PrefixContract {
+    sessionId: string;
+    /** Hex-encoded SHA-256 of stablePrefix bytes at session start. */
+    hash: string;
+}
+/** Narrow adapter contract — Eng-11 / Finding 4: swappable test double. */
+export interface ProviderAdapter {
+    readonly providerId: ProviderId;
+    call(req: ModelRequest): Promise<ModelResult>;
+}
+/** Dependencies injected into makeModelRouter. */
+export interface ModelRouterDeps {
+    adapters: ProviderAdapter[];
+    /** Resolution order for fallback escalation. Defaults to the fixed policy. */
+    escalationOrder?: ProviderId[];
+    /** Write-only sink for observability events (route.*, budget.*, judge.*, cache.*). */
+    emitEvent?: (event: RouterEvent) => void;
+    /** Mutable budget store; keyed by taskId. */
+    budgets?: Map<string, TaskBudget>;
+    /** Mutable hysteresis store; keyed by `${family}:${model}`. */
+    hysteresisStore?: Map<string, HysteresisState>;
+    /** Mutable queue for all-providers-down records; keyed by requestId. */
+    queueStore?: Map<string, QueueRecord>;
+    /** Human review staging queue for judge collisions. */
+    reviewQueue?: Map<string, ModelRequest>;
+    /** Whether the router is ready to dispatch (cold-start guard). */
+    ready?: boolean;
+}
+export interface ModelRouter {
+    classify(req: ModelRequest): Promise<RouteTier>;
+    /**
+     * Resolves the tier → provider decision. Fails closed: when every provider in
+     * the escalation chain is down, returns the same all-providers-down terminal
+     * policy as dispatch() rather than handing back a known-down provider.
+     */
+    route(req: ModelRequest): Promise<RouteDecision | DispatchError>;
+    dispatch(req: ModelRequest): Promise<ModelResult | DispatchError>;
+}
+/** Alias for the routing table + escalation constants — config-level concept. */
+export type RoutingPolicy = {
+    readonly table: Readonly<Record<RouteTier, ProviderId>>;
+    readonly escalationOrder: readonly ProviderId[];
+    readonly hysteresisThreshold: number;
+    readonly maxCacheBreakpoints: number;
+};
+export type DispatchError = {
+    kind: "budget_exceeded";
+    budget: TaskBudget;
+} | {
+    kind: "all_providers_down";
+    queuedRequestId: string;
+} | {
+    kind: "judge_collision_held";
+    candidateId: string;
+} | {
+    kind: "prefix_mutated";
+    expectedHash: string;
+    actualHash: string;
+} | {
+    kind: "router_not_ready";
+} | {
+    kind: "provider_error";
+    providerId: ProviderId;
+    errorKind: ProviderErrorKind;
+};
+export type RouterEvent = {
+    type: "route.classified";
+    taskId: string;
+    tier: RouteTier;
+    fallback: boolean;
+} | {
+    type: "route.resolved";
+    taskId: string;
+    decision: RouteDecision;
+} | {
+    type: "route.fallback";
+    taskId: string;
+    from: ProviderId;
+    to: ProviderId;
+} | {
+    type: "route.all_down_queued";
+    taskId: string;
+    requestId: string;
+} | {
+    type: "provider.cost.charged";
+    taskId: string;
+    requestId: string;
+    tier: RouteTier;
+    tokens: number;
+    dollars: number;
+} | {
+    type: "budget.charged";
+    taskId: string;
+    requestId: string;
+    dollars: number;
+    tokens: number;
+} | {
+    type: "budget.exceeded";
+    taskId: string;
+    budget: TaskBudget;
+} | {
+    type: "judge.collision_held";
+    taskId: string;
+    candidateId: string;
+} | {
+    type: "cache.prefix_mismatch";
+    taskId: string;
+    expectedHash: string;
+    actualHash: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/provider/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/provider/types.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAA;AAE5D,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,WAAW,GACX,QAAQ,CAAA;AAEZ,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,CAAA;AAMzE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd;AAMD,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,GAAG,EAAE,UAAU,CAAA;IACf,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAA;IACpD,yEAAyE;IACzE,YAAY,EAAE,UAAU,CAAA;IACxB,IAAI,EAAE,WAAW,CAAA;IACjB,qFAAqF;IACrF,uBAAuB,CAAC,EAAE,UAAU,CAAA;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,UAAU,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,cAAc,EAAE,MAAM,CAAA;CACvB;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,CAAA;IACpB,IAAI,EAAE,SAAS,CAAA;IACf,wEAAwE;IACxE,YAAY,EAAE,OAAO,CAAA;IACrB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAMD,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAMD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,UAAU,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAMD,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAA;CACb;AAMD,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAC9C;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,UAAU,EAAE,CAAA;IAC9B,sFAAsF;IACtF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACxC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACjC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC9C,wEAAwE;IACxE,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACrC,uDAAuD;IACvD,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/C;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC,CAAA;IAChE,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC,CAAA;CAClE;AAMD,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,eAAe,EAAE,SAAS,UAAU,EAAE,CAAA;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CACrC,CAAA;AAMD,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAMpF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtH;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/provider/types.js

@@ -0,0 +1,4 @@
+// §3 interfaces — pure types, no implementation
+// Spec: docs/specs/09-provider-routing.md
+export {};
+//# sourceMappingURL=types.js.map

package/dist/provider/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/provider/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,0CAA0C"}

package/dist/runtime/agent-cards.d.ts

@@ -0,0 +1,14 @@
+import type { AgentCard } from '../orchestration/index.js';
+export interface CardResolver {
+    resolve(name: string): AgentCard | undefined;
+    names(): string[];
+}
+export declare const DEFAULT_GENERAL_CARD: AgentCard;
+export declare function parseAgentCard(text: string): AgentCard;
+export declare function makeCardResolver(deps: {
+    dir: string;
+    exists: (path: string) => boolean;
+    readDir: (dir: string) => string[];
+    readFile: (path: string) => string;
+}): CardResolver;
+//# sourceMappingURL=agent-cards.d.ts.map

package/dist/runtime/agent-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cards.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-cards.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;IAC5C,KAAK,IAAI,MAAM,EAAE,CAAA;CAClB;AAED,eAAO,MAAM,oBAAoB,EAAE,SASpB,CAAA;AAwBf,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAwBtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAAA;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CACnC,GAAG,YAAY,CAoBf"}

package/dist/runtime/agent-cards.js

@@ -0,0 +1,90 @@
+// AgentCard loader (runtime, ADR-0039/0052).
+//
+// Loads sub-agent capability cards from .aisy/agents/*.md (YAML frontmatter +
+// Markdown body) and always offers a bundled read-only general card so
+// delegation works out of the box. The card is the SOLE capability authority —
+// the model cannot widen tools/skills/MCP beyond what its card declares.
+export const DEFAULT_GENERAL_CARD = Object.freeze({
+    name: 'general',
+    description: 'Read-only general worker (search, read, list).',
+    skills: [],
+    mcpAllowlist: [],
+    toolTiers: Object.freeze({ read_file: 1, list_dir: 1, search_memory: 1 }),
+    maxIterations: 12,
+    contextStrategy: 'compact',
+    provenance: 'builtin',
+});
+function stripQuotes(s) {
+    const t = s.trim();
+    return (t.startsWith('"') && t.endsWith('"')) || (t.startsWith("'") && t.endsWith("'")) ? t.slice(1, -1) : t;
+}
+function parseList(v) {
+    const inner = v.trim().replace(/^\[/, '').replace(/\]$/, '').trim();
+    if (inner.length === 0)
+        return [];
+    return inner.split(',').map((x) => stripQuotes(x)).filter((x) => x.length > 0);
+}
+function parseRecord(v) {
+    const inner = v.trim().replace(/^\{/, '').replace(/\}$/, '').trim();
+    const out = {};
+    if (inner.length === 0)
+        return out;
+    for (const pair of inner.split(',')) {
+        const [k, val] = pair.split(':');
+        if (k && val !== undefined)
+            out[stripQuotes(k)] = Number(val.trim());
+    }
+    return out;
+}
+export function parseAgentCard(text) {
+    const m = /^---\n([\s\S]*?)\n---/.exec(text);
+    if (!m || !m[1])
+        throw new Error('agent card: missing YAML frontmatter');
+    const fm = {};
+    for (const line of m[1].split('\n')) {
+        const idx = line.indexOf(':');
+        if (idx < 0)
+            continue;
+        fm[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+    }
+    const name = fm['name'] ? stripQuotes(fm['name']) : '';
+    if (name.length === 0)
+        throw new Error('agent card: name is required');
+    const ctx = fm['context_strategy'] ? stripQuotes(fm['context_strategy']) : 'compact';
+    const prov = fm['provenance'] ? stripQuotes(fm['provenance']) : 'user';
+    const card = {
+        name,
+        ...(fm['description'] ? { description: stripQuotes(fm['description']) } : {}),
+        skills: fm['skills'] ? parseList(fm['skills']) : [],
+        mcpAllowlist: fm['mcp_allowlist'] ? parseList(fm['mcp_allowlist']) : [],
+        toolTiers: fm['tool_tiers'] ? parseRecord(fm['tool_tiers']) : {},
+        maxIterations: fm['max_iterations'] ? Number(fm['max_iterations']) : 12,
+        contextStrategy: ctx === 'full' ? 'full' : 'compact',
+        provenance: prov === 'builtin' ? 'builtin' : prov === 'community' ? 'community' : 'user',
+    };
+    return card;
+}
+export function makeCardResolver(deps) {
+    const cards = new Map();
+    if (deps.exists(deps.dir)) {
+        for (const f of deps.readDir(deps.dir)) {
+            if (!f.endsWith('.md'))
+                continue;
+            try {
+                const card = parseAgentCard(deps.readFile(`${deps.dir}/${f}`));
+                cards.set(card.name, card);
+            }
+            catch {
+                // skip malformed card; the default remains available
+            }
+        }
+    }
+    // The built-in general card is reserved + read-only: it always wins, so a user
+    // file named general.md cannot shadow it with elevated tools (ADR-0052).
+    cards.set(DEFAULT_GENERAL_CARD.name, DEFAULT_GENERAL_CARD);
+    return {
+        resolve: (name) => cards.get(name),
+        names: () => [...cards.keys()],
+    };
+}
+//# sourceMappingURL=agent-cards.js.map

package/dist/runtime/agent-cards.js.map

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

package/dist/runtime/agent-runner.d.ts

@@ -0,0 +1,30 @@
+import type { GrantStore, SandboxSecurityLevel } from '../safety/index.js';
+import { type ApprovalDecision } from './hook-gate.js';
+import type { Clock, ProviderAdapter, MemoryPort, LoopGuardian, SessionLog, ToolCall, TurnInput, TurnResult } from '../agent-loop/types.js';
+import type { PendingAction } from '../gateway/index.js';
+export interface AgentRunnerDeps {
+    provider: ProviderAdapter;
+    memory: MemoryPort;
+    grants: GrantStore;
+    executeTool: (call: ToolCall) => unknown | Promise<unknown>;
+    /** Human approval round-trip — the transport issues a card and awaits the tap. */
+    approve: (action: PendingAction) => Promise<ApprovalDecision>;
+    guardian: LoopGuardian;
+    sessionLog: SessionLog;
+    clock?: Clock;
+    sandboxSecurityLevel?: SandboxSecurityLevel;
+    maxReplans?: number;
+    maxTotalToolCalls?: number;
+    /** Mid-turn budget probe forwarded to the loop (ADR-0051). */
+    budgetCheck?: (usage: {
+        sessionId: string;
+        inputTokens: number;
+        outputTokens: number;
+        dollars: number;
+    }) => boolean | Promise<boolean>;
+}
+export interface AgentRunner {
+    handle(input: TurnInput): Promise<TurnResult>;
+}
+export declare function makeAgentRunner(deps: AgentRunnerDeps): AgentRunner;
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/runtime/agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-runner.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEpE,OAAO,KAAK,EAEV,KAAK,EACL,eAAe,EACf,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACX,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,CAAA;IACzB,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,kFAAkF;IAClF,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC7D,QAAQ,EAAE,YAAY,CAAA;IACtB,UAAU,EAAE,UAAU,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QACpB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,OAAO,EAAE,MAAM,CAAA;KAChB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CAC9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CA4BlE"}

package/dist/runtime/agent-runner.js

@@ -0,0 +1,37 @@
+// Composition root (runtime).
+//
+// Wires the safety-critical core into one runnable agent: SafetyPolicy + the
+// grant store + the HookGate (approval round-trip) feed the agent loop, which
+// drives the provider and tool execution. Everything that touches the outside
+// world — the LLM provider, tool implementations, the human approval port,
+// memory, guardian, session log — is injected, so this stays pure and testable
+// and the transport (Telegram) lives outside, in the app package.
+import { makeSafetyPolicy } from '../safety/index.js';
+import { makeHookGate } from './hook-gate.js';
+import { makeAgentLoop } from '../agent-loop/index.js';
+export function makeAgentRunner(deps) {
+    const clock = deps.clock ?? { now: () => new Date().toISOString() };
+    const safety = makeSafetyPolicy({
+        grants: deps.grants,
+        ...(deps.sandboxSecurityLevel !== undefined
+            ? { sandboxSecurityLevel: deps.sandboxSecurityLevel }
+            : {}),
+    });
+    const hookGate = makeHookGate({ safety, grants: deps.grants, approve: deps.approve });
+    const loop = makeAgentLoop({
+        clock,
+        provider: deps.provider,
+        hookGate,
+        memory: deps.memory,
+        guardian: deps.guardian,
+        sessionLog: deps.sessionLog,
+        executeTool: deps.executeTool,
+        ...(deps.maxReplans !== undefined ? { maxReplans: deps.maxReplans } : {}),
+        ...(deps.maxTotalToolCalls !== undefined ? { maxTotalToolCalls: deps.maxTotalToolCalls } : {}),
+        ...(deps.budgetCheck !== undefined ? { budgetCheck: deps.budgetCheck } : {}),
+    });
+    return {
+        handle: (input) => loop.runTurn(input),
+    };
+}
+//# sourceMappingURL=agent-runner.js.map

package/dist/runtime/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../src/runtime/agent-runner.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,kEAAkE;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,YAAY,EAAyB,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAwCtD,MAAM,UAAU,eAAe,CAAC,IAAqB;IACnD,MAAM,KAAK,GAAU,IAAI,CAAC,KAAK,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;IAE1E,MAAM,MAAM,GAAG,gBAAgB,CAAC;QAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,oBAAoB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE;YACrD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAErF,MAAM,IAAI,GAAc,aAAa,CAAC;QACpC,KAAK;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ;QACR,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC,CAAA;IAEF,OAAO;QACL,MAAM,EAAE,CAAC,KAAgB,EAAuB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;KACvE,CAAA;AACH,CAAC"}