@vraxis/agent-v 0.4.0

package/dist/core/contracts.d.ts

@@ -0,0 +1,135 @@
+import type { AgentEvent, EventSink } from "./events.js";
+import type { OutputContract } from "./output.js";
+import type { AgentInput, ContextArtifact, EngineDescriptor, JsonObject, JsonValue, RunContext, RunProvenance, RuntimeReadiness, TokenUsage, ExecutionScope } from "./types.js";
+export interface StructuredGenerationRequest<T> extends RunContext {
+    input: AgentInput;
+    output: OutputContract<T>;
+    model?: string;
+    temperature?: number;
+}
+export interface StructuredGenerationResult<T> {
+    runId: string;
+    output: T;
+    provenance: RunProvenance;
+    durationMs: number;
+    usage?: TokenUsage;
+}
+export interface StructuredModelEngine {
+    readonly descriptor: EngineDescriptor;
+    generate<T>(request: StructuredGenerationRequest<T>, events?: EventSink): Promise<StructuredGenerationResult<T>>;
+}
+export interface ToolExecutionContext extends RunContext {
+    toolCallId: string;
+    artifacts: readonly ContextArtifact[];
+}
+/**
+ * Host capability exposed to a model.
+ * Both model-supplied input and implementation-supplied output are validated.
+ */
+export interface AgentTool<I = unknown, O = JsonValue> {
+    name: string;
+    version: string;
+    description: string;
+    input: OutputContract<I>;
+    output: OutputContract<O>;
+    requiresApproval: boolean;
+    risk: ToolRisk;
+    sideEffect: ToolSideEffect;
+    requiredPermissions: readonly string[];
+    timeoutMs: number;
+    execute(input: I, context: ToolExecutionContext): Promise<O> | O;
+}
+export type ToolRisk = "read" | "write" | "external-side-effect" | "privileged";
+export type ToolSideEffect = "none" | "idempotent" | "non-idempotent";
+export interface ApprovalRequest {
+    id: string;
+    runId: string;
+    toolName: string;
+    input: unknown;
+    reason: string;
+    metadata?: JsonObject;
+    toolVersion?: string;
+    risk: ToolRisk;
+    sideEffect: ToolSideEffect;
+    requiredPermissions: readonly string[];
+    scope: ExecutionScope;
+}
+/** Host authority that resolves an approval request before a guarded tool executes. */
+export interface ApprovalPolicy {
+    decide(request: ApprovalRequest): Promise<"approved" | "denied">;
+}
+export interface ToolAgentRequest<T = string> extends RunContext {
+    input: AgentInput;
+    tools?: readonly AgentTool[];
+    output?: OutputContract<T>;
+    maxSteps?: number;
+    model?: string;
+    approvalPolicy?: ApprovalPolicy;
+}
+export interface ToolAgentResult<T = string> {
+    runId: string;
+    output: T;
+    text: string;
+    steps: number;
+    provenance: RunProvenance;
+    durationMs: number;
+    usage?: TokenUsage;
+}
+export interface AgentRunStream<T> {
+    events: AsyncIterable<AgentEvent>;
+    result: Promise<ToolAgentResult<T>>;
+}
+/** Bounded model/tool-loop engine with normalized run and streaming results. */
+export interface ToolAgentEngine {
+    readonly descriptor: EngineDescriptor;
+    run<T = string>(request: ToolAgentRequest<T>, events?: EventSink): Promise<ToolAgentResult<T>>;
+    stream<T = string>(request: ToolAgentRequest<T>, events?: EventSink): Promise<AgentRunStream<T>>;
+}
+export interface CodingRuntimeRequest<T> extends RunContext {
+    input: AgentInput;
+    output: OutputContract<T>;
+    runtimeId: string;
+    runtimeModel?: string;
+    workspacePath?: string;
+    workspaceAccess?: "read-only" | "workspace-write";
+    maxAttempts?: 1 | 2;
+}
+export interface CodingRuntimeResult<T> extends StructuredGenerationResult<T> {
+    runtimeId: string;
+    activityCount: number;
+    attempts: number;
+}
+/** Installed coding-agent runtime operating against an explicitly scoped workspace. */
+export interface CodingRuntimeEngine {
+    readonly descriptor: EngineDescriptor;
+    inspect(runtimeId: string): Promise<RuntimeReadiness>;
+    probe(runtimeId: string, runtimeModel?: string): Promise<RuntimeReadiness>;
+    run<T>(request: CodingRuntimeRequest<T>, events?: EventSink): Promise<CodingRuntimeResult<T>>;
+}
+export interface AgentSession {
+    id: string;
+    agentId: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: readonly import("./types.js").AgentMessage[];
+    metadata?: JsonObject;
+    scope: ExecutionScope;
+}
+/** Scope-isolated conversational state port. */
+export interface SessionStore {
+    get(scope: ExecutionScope, id: string): Promise<AgentSession | undefined>;
+    save(session: AgentSession): Promise<void>;
+    delete(scope: ExecutionScope, id: string): Promise<void>;
+}
+/** Scope-isolated normalized execution ledger. */
+export interface RunEventStore {
+    append(event: AgentEvent): Promise<void>;
+    list(scope: ExecutionScope, runId: string): Promise<readonly AgentEvent[]>;
+}
+export interface CredentialResolver {
+    resolve(reference: string): Promise<string | undefined>;
+}
+export interface SessionSaveOptions {
+    expectedUpdatedAt?: string;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/core/contracts.d.ts.map

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

package/dist/core/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/core/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/core/contracts.ts"],"names":[],"mappings":""}

package/dist/core/errors.d.ts

@@ -0,0 +1,12 @@
+import type { FailureCode, SafeFailure } from "./types.js";
+export declare class AgentVError extends Error implements SafeFailure {
+    readonly code: FailureCode;
+    readonly retryable: boolean;
+    readonly cause?: unknown;
+    constructor(code: FailureCode, message: string, options?: {
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+export declare function safeFailure(error: unknown): SafeFailure;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,WAAY,SAAQ,KAAM,YAAW,WAAW;IAC3D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOvG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAWvD"}

package/dist/core/errors.js

@@ -0,0 +1,27 @@
+export class AgentVError extends Error {
+    code;
+    retryable;
+    cause;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "AgentVError";
+        this.code = code;
+        this.retryable = options.retryable ?? false;
+        if (options.cause !== undefined)
+            this.cause = options.cause;
+    }
+}
+export function safeFailure(error) {
+    if (error instanceof AgentVError)
+        return error;
+    if (error instanceof Error && error.name === "AbortError") {
+        return { code: "cancelled", message: "The agent run was cancelled.", retryable: true, cause: error };
+    }
+    return {
+        code: "invocation-failed",
+        message: "The agent engine failed before returning a reviewable result.",
+        retryable: false,
+        cause: error,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAc;IAClB,SAAS,CAAU;IACV,KAAK,CAAW;IAElC,YAAY,IAAiB,EAAE,OAAe,EAAE,UAAoD,EAAE;QACpG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,8BAA8B,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACvG,CAAC;IACD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,+DAA+D;QACxE,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,KAAK;KACb,CAAC;AACJ,CAAC"}

package/dist/core/events.d.ts

@@ -0,0 +1,74 @@
+import type { Citation, ExecutionScope, FailureCode, JsonObject, JsonValue, RunProvenance, TokenUsage } from "./types.js";
+interface EventBase {
+    runId: string;
+    timestamp: string;
+    scope: ExecutionScope;
+    traceId?: string;
+}
+export type AgentEvent = (EventBase & {
+    type: "run.started";
+    provenance: RunProvenance;
+}) | (EventBase & {
+    type: "run.completed";
+    durationMs: number;
+    usage?: TokenUsage;
+}) | (EventBase & {
+    type: "run.failed";
+    code: FailureCode;
+    message: string;
+    retryable: boolean;
+}) | (EventBase & {
+    type: "model.started";
+    step: number;
+}) | (EventBase & {
+    type: "model.completed";
+    step: number;
+    durationMs?: number;
+    usage?: TokenUsage;
+}) | (EventBase & {
+    type: "text.delta";
+    delta: string;
+}) | (EventBase & {
+    type: "tool.requested";
+    toolCallId: string;
+    toolName: string;
+    input?: JsonValue;
+}) | (EventBase & {
+    type: "tool.completed";
+    toolCallId: string;
+    toolName: string;
+    durationMs?: number;
+}) | (EventBase & {
+    type: "tool.failed";
+    toolCallId: string;
+    toolName: string;
+    message: string;
+}) | (EventBase & {
+    type: "approval.requested";
+    approvalId: string;
+    toolName: string;
+    reason: string;
+}) | (EventBase & {
+    type: "approval.resolved";
+    approvalId: string;
+    decision: "approved" | "denied";
+}) | (EventBase & {
+    type: "citation";
+    citation: Citation;
+}) | (EventBase & {
+    type: "status";
+    message: string;
+    metadata?: JsonObject;
+});
+export interface EventSink {
+    emit(event: AgentEvent): void | Promise<void>;
+}
+export declare const noopEventSink: EventSink;
+export declare class MemoryEventSink implements EventSink {
+    readonly events: AgentEvent[];
+    emit(event: AgentEvent): void;
+}
+export declare function fanOutEventSink(...sinks: readonly EventSink[]): EventSink;
+export declare function eventTimestamp(): string;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/core/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1H,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAClB,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,aAAa,CAAA;CAAE,CAAC,GAChE,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,GAC/E,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,GAC5F,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACrD,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,GAChG,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACnD,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,GACjG,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACnG,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5F,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAClG,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAAA;CAAE,CAAC,GAChG,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC,GACtD,CAAC,SAAS,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAE7E,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,aAAa,EAAE,SAAyB,CAAC;AAEtD,qBAAa,eAAgB,YAAW,SAAS;IAC/C,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;IAEnC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAG9B;AAED,wBAAgB,eAAe,CAAC,GAAG,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAEzE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/core/events.js

@@ -0,0 +1,14 @@
+export const noopEventSink = { emit() { } };
+export class MemoryEventSink {
+    events = [];
+    emit(event) {
+        this.events.push(event);
+    }
+}
+export function fanOutEventSink(...sinks) {
+    return { async emit(event) { await Promise.all(sinks.map((sink) => sink.emit(event))); } };
+}
+export function eventTimestamp() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAC,MAAM,aAAa,GAAc,EAAE,IAAI,KAAI,CAAC,EAAE,CAAC;AAEtD,MAAM,OAAO,eAAe;IACjB,MAAM,GAAiB,EAAE,CAAC;IAEnC,IAAI,CAAC,KAAiB;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,GAAG,KAA2B;IAC5D,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/extensions.d.ts

@@ -0,0 +1,80 @@
+import type { AgentTool, ToolAgentRequest } from "./contracts.js";
+import type { AgentCapability, ContextArtifact, JsonObject } from "./types.js";
+/** Portable, versioned guidance with a constraining tool allowlist. */
+export interface AgentSkill {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    instructions: string;
+    tools: readonly string[];
+    preapprovedTools?: readonly string[];
+    license?: string;
+    compatibility?: string;
+    source?: {
+        format: "agent-skills" | "native";
+        uri: string;
+    };
+    artifacts?: readonly ContextArtifact[];
+    metadata?: JsonObject;
+}
+interface AgentBlueprintBase {
+    id: string;
+    name: string;
+    description?: string;
+    instructions: string;
+    skills: readonly string[];
+    tools: readonly string[];
+    requiredCapabilities: readonly AgentCapability[];
+    maxSteps?: number;
+    metadata?: JsonObject;
+}
+/** Application-owned composition selecting exactly one engine or configured profile. */
+export type AgentBlueprint = AgentBlueprintBase & ({
+    engineId: string;
+    profileId?: never;
+} | {
+    profileId: string;
+    engineId?: never;
+});
+export interface AgentRunMiddleware {
+    id: string;
+    beforeRun?<T>(request: ToolAgentRequest<T>): Promise<ToolAgentRequest<T>> | ToolAgentRequest<T>;
+    afterRun?<T>(result: T): Promise<T> | T;
+    onError?(error: unknown): Promise<void> | void;
+}
+export interface AgentExtension {
+    id: string;
+    version: string;
+    capabilities?: readonly AgentCapability[];
+    tools?: readonly AgentTool[];
+    skills?: readonly AgentSkill[];
+    middleware?: readonly AgentRunMiddleware[];
+}
+declare class NamedRegistry<T extends {
+    id?: string;
+    name?: string;
+}> {
+    private readonly values;
+    register(value: T, explicitId?: string): void;
+    get(id: string): T | undefined;
+    require(id: string): T;
+    list(): readonly T[];
+}
+export declare class ExtensionRegistry {
+    readonly tools: NamedRegistry<AgentTool<unknown, import("./types.js").JsonValue>>;
+    readonly skills: NamedRegistry<AgentSkill>;
+    readonly middleware: NamedRegistry<AgentRunMiddleware>;
+    private readonly extensions;
+    use(extension: AgentExtension): this;
+    list(): readonly AgentExtension[];
+}
+/** Defines and validates a portable agent skill. */
+export declare function defineSkill(skill: AgentSkill): AgentSkill;
+/** Defines a validated tool and enforces approval for high-risk classifications. */
+export declare function defineTool<I, O extends import("./types.js").JsonValue>(tool: AgentTool<I, O>): AgentTool<I, O>;
+export declare function defineExtension(extension: AgentExtension): AgentExtension;
+/** Defines and validates an application-owned agent blueprint. */
+export declare function defineAgent(blueprint: AgentBlueprint): AgentBlueprint;
+export {};
+//# sourceMappingURL=extensions.d.ts.map

package/dist/core/extensions.d.ts.map

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

package/dist/core/extensions.js

@@ -0,0 +1,77 @@
+class NamedRegistry {
+    values = new Map();
+    register(value, explicitId) {
+        const id = explicitId ?? value.id ?? value.name;
+        if (!id)
+            throw new Error("Registry entries require an id or name.");
+        if (this.values.has(id))
+            throw new Error(`An entry named ${id} is already registered.`);
+        this.values.set(id, value);
+    }
+    get(id) {
+        return this.values.get(id);
+    }
+    require(id) {
+        const value = this.get(id);
+        if (!value)
+            throw new Error(`No entry named ${id} is registered.`);
+        return value;
+    }
+    list() {
+        return [...this.values.values()];
+    }
+}
+export class ExtensionRegistry {
+    tools = new NamedRegistry();
+    skills = new NamedRegistry();
+    middleware = new NamedRegistry();
+    extensions = new Map();
+    use(extension) {
+        if (this.extensions.has(extension.id))
+            throw new Error(`Extension ${extension.id} is already installed.`);
+        this.extensions.set(extension.id, extension);
+        for (const tool of extension.tools ?? [])
+            this.tools.register(tool, tool.name);
+        for (const skill of extension.skills ?? [])
+            this.skills.register(skill);
+        for (const middleware of extension.middleware ?? [])
+            this.middleware.register(middleware);
+        return this;
+    }
+    list() {
+        return [...this.extensions.values()];
+    }
+}
+/** Defines and validates a portable agent skill. */
+export function defineSkill(skill) {
+    if (!skill.id.trim() || !skill.name.trim() || !skill.version.trim())
+        throw new Error("Skills require a stable id, name, and version.");
+    if (new Set(skill.tools).size !== skill.tools.length)
+        throw new Error(`Skill ${skill.id} declares duplicate tools.`);
+    return Object.freeze({ ...skill });
+}
+/** Defines a validated tool and enforces approval for high-risk classifications. */
+export function defineTool(tool) {
+    if (!tool.name.trim() || !tool.version.trim())
+        throw new Error("Tools require a stable name and version.");
+    if (tool.timeoutMs <= 0 || !Number.isFinite(tool.timeoutMs))
+        throw new Error(`Tool ${tool.name} requires a positive finite timeoutMs.`);
+    if ((tool.risk === "external-side-effect" || tool.risk === "privileged") && !tool.requiresApproval) {
+        throw new Error(`Tool ${tool.name} must require approval because its risk is ${tool.risk}.`);
+    }
+    return Object.freeze({ ...tool });
+}
+export function defineExtension(extension) {
+    return Object.freeze({ ...extension });
+}
+/** Defines and validates an application-owned agent blueprint. */
+export function defineAgent(blueprint) {
+    if (!blueprint.id.trim() || !blueprint.name.trim())
+        throw new Error("Agents require a stable id and name.");
+    if (!blueprint.instructions.trim())
+        throw new Error(`Agent ${blueprint.id} requires instructions.`);
+    if (new Set(blueprint.skills).size !== blueprint.skills.length || new Set(blueprint.tools).size !== blueprint.tools.length)
+        throw new Error(`Agent ${blueprint.id} contains duplicate skill or tool ids.`);
+    return Object.freeze({ ...blueprint });
+}
+//# sourceMappingURL=extensions.js.map

package/dist/core/extensions.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./agent-v.js";
+export * from "./config.js";
+export * from "./contracts.js";
+export * from "./errors.js";
+export * from "./events.js";
+export * from "./extensions.js";
+export * from "./output.js";
+export * from "./registry.js";
+export * from "./memory.js";
+export * from "./types.js";
+export * from "./version.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,12 @@
+export * from "./agent-v.js";
+export * from "./config.js";
+export * from "./contracts.js";
+export * from "./errors.js";
+export * from "./events.js";
+export * from "./extensions.js";
+export * from "./output.js";
+export * from "./registry.js";
+export * from "./memory.js";
+export * from "./types.js";
+export * from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

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

package/dist/core/memory.d.ts

@@ -0,0 +1,15 @@
+import type { AgentEvent } from "./events.js";
+import type { AgentSession, RunEventStore, SessionStore } from "./contracts.js";
+import type { ExecutionScope } from "./types.js";
+export declare class MemorySessionStore implements SessionStore {
+    private readonly sessions;
+    get(scope: ExecutionScope, id: string): Promise<AgentSession | undefined>;
+    save(session: AgentSession): Promise<void>;
+    delete(scope: ExecutionScope, id: string): Promise<void>;
+}
+export declare class MemoryRunEventStore implements RunEventStore {
+    private readonly events;
+    append(event: AgentEvent): Promise<void>;
+    list(scope: ExecutionScope, runId: string): Promise<readonly AgentEvent[]>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/core/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IACtD,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIzE,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IACrC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;CAGjF"}

package/dist/core/memory.js

@@ -0,0 +1,21 @@
+function scopedKey(scope, id) { return `${scope.tenantId}\u0000${scope.projectId}\u0000${scope.principalId}\u0000${scope.engagementId ?? ""}\u0000${id}`; }
+function sameScope(left, right) {
+    return left.tenantId === right.tenantId && left.projectId === right.projectId && left.principalId === right.principalId && left.engagementId === right.engagementId;
+}
+export class MemorySessionStore {
+    sessions = new Map();
+    async get(scope, id) {
+        const session = this.sessions.get(scopedKey(scope, id));
+        return session ? structuredClone(session) : undefined;
+    }
+    async save(session) { this.sessions.set(scopedKey(session.scope, session.id), structuredClone(session)); }
+    async delete(scope, id) { this.sessions.delete(scopedKey(scope, id)); }
+}
+export class MemoryRunEventStore {
+    events = [];
+    async append(event) { this.events.push(structuredClone(event)); }
+    async list(scope, runId) {
+        return this.events.filter((event) => event.runId === runId && sameScope(event.scope, scope));
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/core/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"AAIA,SAAS,SAAS,CAAC,KAAqB,EAAE,EAAU,IAAY,OAAO,GAAG,KAAK,CAAC,QAAQ,SAAS,KAAK,CAAC,SAAS,SAAS,KAAK,CAAC,WAAW,SAAS,KAAK,CAAC,YAAY,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;AAE3L,SAAS,SAAS,CAAC,IAAoB,EAAE,KAAqB;IAC5D,OAAO,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,CAAC;AACtK,CAAC;AAED,MAAM,OAAO,kBAAkB;IACZ,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5D,KAAK,CAAC,GAAG,CAAC,KAAqB,EAAE,EAAU;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAqB,IAAmB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvI,KAAK,CAAC,MAAM,CAAC,KAAqB,EAAE,EAAU,IAAmB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/G;AAED,MAAM,OAAO,mBAAmB;IACb,MAAM,GAAiB,EAAE,CAAC;IAC3C,KAAK,CAAC,MAAM,CAAC,KAAiB,IAAmB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,KAAqB,EAAE,KAAa;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/F,CAAC;CACF"}

package/dist/core/output.d.ts

@@ -0,0 +1,10 @@
+import type { JsonObject } from "./types.js";
+export interface OutputContract<T> {
+    name: string;
+    description?: string;
+    jsonSchema: JsonObject;
+    parse(value: unknown): T;
+}
+export declare function defineOutput<T>(contract: OutputContract<T>): OutputContract<T>;
+export declare const textOutput: OutputContract<string>;
+//# sourceMappingURL=output.d.ts.map

package/dist/core/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAG9E;AAED,eAAO,MAAM,UAAU,wBAOrB,CAAC"}

package/dist/core/output.js

@@ -0,0 +1,15 @@
+export function defineOutput(contract) {
+    if (!contract.name.trim())
+        throw new Error("An output contract requires a name.");
+    return Object.freeze({ ...contract });
+}
+export const textOutput = defineOutput({
+    name: "text",
+    jsonSchema: { type: "string" },
+    parse(value) {
+        if (typeof value !== "string")
+            throw new TypeError("Expected a text output.");
+        return value;
+    },
+});
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,YAAY,CAAI,QAA2B;IACzD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAS;IAC7C,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,KAAK,CAAC,KAAK;QACT,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC,CAAC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,13 @@
+import type { CodingRuntimeEngine, StructuredModelEngine, ToolAgentEngine } from "./contracts.js";
+import type { AgentCapability, EngineDescriptor, EngineKind } from "./types.js";
+type AnyEngine = StructuredModelEngine | ToolAgentEngine | CodingRuntimeEngine;
+export declare class EngineRegistry {
+    private readonly engines;
+    register(engine: AnyEngine): this;
+    get(id: string): AnyEngine | undefined;
+    require<T extends AnyEngine = AnyEngine>(id: string, kind?: EngineKind): T;
+    find(kind: EngineKind, capabilities?: readonly AgentCapability[]): readonly EngineDescriptor[];
+    list(): readonly EngineDescriptor[];
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhF,KAAK,SAAS,GAAG,qBAAqB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAE/E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAExD,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAMjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItC,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,CAAC;IAQ1E,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,GAAE,SAAS,eAAe,EAAO,GAAG,SAAS,gBAAgB,EAAE;IAMlG,IAAI,IAAI,SAAS,gBAAgB,EAAE;CAGpC"}