agent-framework-js 0.1.1

package/dist/skills/index.d.ts

@@ -0,0 +1,30 @@
+import { S as Skill } from '../skill-DfNChtJN.js';
+export { a as SkillSource, d as defineSkill, l as loadSource } from '../skill-DfNChtJN.js';
+
+/**
+ * Client-side keyword/text index over skill descriptions. No embeddings and no
+ * extra provider — relevance is decided by simple token overlap so it runs fully
+ * in the browser/edge. Full content is loaded only after a skill is selected.
+ * (FR-017, FR-017a)
+ *
+ * @packageDocumentation
+ */
+
+/** Indexes skills by description and selects relevant ones for a prompt. */
+declare class SkillIndex {
+    private readonly entries;
+    constructor(skills?: Skill[]);
+    /** Add a skill to the index (description-only). */
+    add(skill: Skill): void;
+    /**
+     * Select skills relevant to `prompt` by keyword overlap with their descriptions.
+     *
+     * @param prompt - The user prompt.
+     * @param minOverlap - Minimum overlapping tokens to count as relevant. Default 1.
+     */
+    select(prompt: string, minOverlap?: number): Skill[];
+    /** Load the full content of a selected skill (concatenated sources). (FR-017) */
+    load(skill: Skill): Promise<string>;
+}
+
+export { Skill, SkillIndex };

package/dist/skills/index.js

@@ -0,0 +1,3 @@
+export { SkillIndex, defineSkill, loadSource } from '../chunk-YCBDEEAV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/thread-CWVzTyti.d.ts

@@ -0,0 +1,51 @@
+import { M as Message } from './types-Cn1g9Tg4.js';
+import { P as Provider } from './provider-osAtfZ7x.js';
+
+/**
+ * Conversation thread with automatic compaction. When a thread approaches the
+ * model's input-token budget it is summarized into a compact form so the
+ * conversation can continue. (FR-004, FR-004a, FR-004b)
+ *
+ * @packageDocumentation
+ */
+
+/** Options controlling a thread's compaction behavior. */
+interface ThreadOptions {
+    /** Fraction of `maxInputTokens` at which compaction triggers. Default 0.9. */
+    compactionThreshold?: number;
+    /** Provider used to summarize; defaults to the agent's own provider. (FR-004b) */
+    compactionModel?: Provider;
+}
+/** Rough token estimate (~4 chars/token) — avoids a tokenizer dependency. */
+declare function estimateTokens(messages: Message[]): number;
+/** A multi-turn conversation that preserves context and compacts when large. */
+declare class Thread {
+    readonly id: string;
+    messages: Message[];
+    /** Whether the thread has been compacted at least once. */
+    compacted: boolean;
+    constructor(id?: string, messages?: Message[]);
+    /** Append a message. */
+    add(message: Message): void;
+    /** Serializable snapshot for persistence. */
+    toJSON(): {
+        id: string;
+        messages: Message[];
+        compacted: boolean;
+    };
+    /** Restore a thread from a snapshot. */
+    static fromJSON(data: {
+        id: string;
+        messages: Message[];
+        compacted?: boolean;
+    }): Thread;
+    /**
+     * Compact the thread if it exceeds the threshold. System messages and the most
+     * recent turn are preserved; older turns are summarized via the model.
+     *
+     * @returns true if compaction occurred.
+     */
+    maybeCompact(provider: Provider, options?: ThreadOptions): Promise<boolean>;
+}
+
+export { Thread as T, type ThreadOptions as a, estimateTokens as e };

package/dist/thread-Dfo9LLf7.d.cts

@@ -0,0 +1,51 @@
+import { M as Message } from './types-Cn1g9Tg4.cjs';
+import { P as Provider } from './provider-CMAymr1b.cjs';
+
+/**
+ * Conversation thread with automatic compaction. When a thread approaches the
+ * model's input-token budget it is summarized into a compact form so the
+ * conversation can continue. (FR-004, FR-004a, FR-004b)
+ *
+ * @packageDocumentation
+ */
+
+/** Options controlling a thread's compaction behavior. */
+interface ThreadOptions {
+    /** Fraction of `maxInputTokens` at which compaction triggers. Default 0.9. */
+    compactionThreshold?: number;
+    /** Provider used to summarize; defaults to the agent's own provider. (FR-004b) */
+    compactionModel?: Provider;
+}
+/** Rough token estimate (~4 chars/token) — avoids a tokenizer dependency. */
+declare function estimateTokens(messages: Message[]): number;
+/** A multi-turn conversation that preserves context and compacts when large. */
+declare class Thread {
+    readonly id: string;
+    messages: Message[];
+    /** Whether the thread has been compacted at least once. */
+    compacted: boolean;
+    constructor(id?: string, messages?: Message[]);
+    /** Append a message. */
+    add(message: Message): void;
+    /** Serializable snapshot for persistence. */
+    toJSON(): {
+        id: string;
+        messages: Message[];
+        compacted: boolean;
+    };
+    /** Restore a thread from a snapshot. */
+    static fromJSON(data: {
+        id: string;
+        messages: Message[];
+        compacted?: boolean;
+    }): Thread;
+    /**
+     * Compact the thread if it exceeds the threshold. System messages and the most
+     * recent turn are preserved; older turns are summarized via the model.
+     *
+     * @returns true if compaction occurred.
+     */
+    maybeCompact(provider: Provider, options?: ThreadOptions): Promise<boolean>;
+}
+
+export { Thread as T, type ThreadOptions as a, estimateTokens as e };

package/dist/tool-BZg_znMZ.d.cts

@@ -0,0 +1,50 @@
+import { J as JSONSchema } from './types-Cn1g9Tg4.cjs';
+
+/**
+ * The uniform tool contract. Every capability exposed to an agent — whether a
+ * local function or an MCP-provided tool — implements this single interface, with
+ * a JSON Schema (MCP-popularized) describing its inputs/outputs. The framework
+ * ships no built-in tools. (FR-009, FR-012d, Constitution V)
+ *
+ * @packageDocumentation
+ */
+
+/** A callable capability available to an agent. */
+interface Tool<I = unknown, O = unknown> {
+    /** Unique name. When provided by an MCP server it is namespaced as `server.tool`. */
+    name: string;
+    /** Natural-language description used by the model to decide when to call it. */
+    description: string;
+    /** JSON Schema for the arguments; validated before invocation. */
+    inputSchema: JSONSchema;
+    /** Optional JSON Schema describing the result. */
+    outputSchema?: JSONSchema;
+    /** Origin: `"local"` for code tools, or an MCP server id. */
+    source?: "local" | string;
+    /** Whether the tool is currently presented to the agent. Defaults to true. */
+    enabled?: boolean;
+    /** Execute the tool with validated arguments. */
+    run(args: I): Promise<O>;
+}
+/**
+ * Define a local function tool with full type inference.
+ *
+ * @example
+ * ```ts
+ * const add = defineTool({
+ *   name: "add",
+ *   description: "Add two numbers.",
+ *   inputSchema: { type: "object", properties: { a: { type: "number" }, b: { type: "number" } }, required: ["a", "b"] },
+ *   run: async ({ a, b }: { a: number; b: number }) => ({ sum: a + b }),
+ * });
+ * ```
+ */
+declare function defineTool<I, O>(tool: {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+    run: (args: I) => Promise<O>;
+}): Tool<I, O>;
+
+export { type Tool as T, defineTool as d };

package/dist/tool-CSCC87OD.d.ts

@@ -0,0 +1,50 @@
+import { J as JSONSchema } from './types-Cn1g9Tg4.js';
+
+/**
+ * The uniform tool contract. Every capability exposed to an agent — whether a
+ * local function or an MCP-provided tool — implements this single interface, with
+ * a JSON Schema (MCP-popularized) describing its inputs/outputs. The framework
+ * ships no built-in tools. (FR-009, FR-012d, Constitution V)
+ *
+ * @packageDocumentation
+ */
+
+/** A callable capability available to an agent. */
+interface Tool<I = unknown, O = unknown> {
+    /** Unique name. When provided by an MCP server it is namespaced as `server.tool`. */
+    name: string;
+    /** Natural-language description used by the model to decide when to call it. */
+    description: string;
+    /** JSON Schema for the arguments; validated before invocation. */
+    inputSchema: JSONSchema;
+    /** Optional JSON Schema describing the result. */
+    outputSchema?: JSONSchema;
+    /** Origin: `"local"` for code tools, or an MCP server id. */
+    source?: "local" | string;
+    /** Whether the tool is currently presented to the agent. Defaults to true. */
+    enabled?: boolean;
+    /** Execute the tool with validated arguments. */
+    run(args: I): Promise<O>;
+}
+/**
+ * Define a local function tool with full type inference.
+ *
+ * @example
+ * ```ts
+ * const add = defineTool({
+ *   name: "add",
+ *   description: "Add two numbers.",
+ *   inputSchema: { type: "object", properties: { a: { type: "number" }, b: { type: "number" } }, required: ["a", "b"] },
+ *   run: async ({ a, b }: { a: number; b: number }) => ({ sum: a + b }),
+ * });
+ * ```
+ */
+declare function defineTool<I, O>(tool: {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+    run: (args: I) => Promise<O>;
+}): Tool<I, O>;
+
+export { type Tool as T, defineTool as d };

package/dist/tools/index.cjs

@@ -0,0 +1,27 @@
+'use strict';
+
+var chunkIU3LS5FC_cjs = require('../chunk-IU3LS5FC.cjs');
+var chunkTAMJ5HSR_cjs = require('../chunk-TAMJ5HSR.cjs');
+require('../chunk-MQ2XTH3S.cjs');
+require('../chunk-IJASUMIQ.cjs');
+
+
+
+Object.defineProperty(exports, "defineTool", {
+  enumerable: true,
+  get: function () { return chunkIU3LS5FC_cjs.defineTool; }
+});
+Object.defineProperty(exports, "ToolRegistry", {
+  enumerable: true,
+  get: function () { return chunkTAMJ5HSR_cjs.ToolRegistry; }
+});
+Object.defineProperty(exports, "namespacedName", {
+  enumerable: true,
+  get: function () { return chunkTAMJ5HSR_cjs.namespacedName; }
+});
+Object.defineProperty(exports, "validateArgs", {
+  enumerable: true,
+  get: function () { return chunkTAMJ5HSR_cjs.validateArgs; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/tools/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/tools/index.d.cts

@@ -0,0 +1,21 @@
+export { T as Tool, d as defineTool } from '../tool-BZg_znMZ.cjs';
+import { J as JSONSchema } from '../types-Cn1g9Tg4.cjs';
+export { T as ToolRegistry, a as ToolResult, n as namespacedName } from '../registry-D4fThGiN.cjs';
+import '../provider-CMAymr1b.cjs';
+import '../errors-CjVz4W_5.cjs';
+
+/**
+ * JSON Schema validation for tool arguments, backed by Ajv. Invalid arguments are
+ * rejected before a tool runs and reported as a typed error the agent can act on.
+ * (FR-011)
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Validate `args` against `schema`. Returns the args on success; throws a
+ * {@link ValidationError} listing the failures otherwise.
+ */
+declare function validateArgs<T = unknown>(schema: JSONSchema, args: unknown): T;
+
+export { validateArgs };

package/dist/tools/index.d.ts

@@ -0,0 +1,21 @@
+export { T as Tool, d as defineTool } from '../tool-CSCC87OD.js';
+import { J as JSONSchema } from '../types-Cn1g9Tg4.js';
+export { T as ToolRegistry, a as ToolResult, n as namespacedName } from '../registry-CpO0yH5v.js';
+import '../provider-osAtfZ7x.js';
+import '../errors-CjVz4W_5.js';
+
+/**
+ * JSON Schema validation for tool arguments, backed by Ajv. Invalid arguments are
+ * rejected before a tool runs and reported as a typed error the agent can act on.
+ * (FR-011)
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Validate `args` against `schema`. Returns the args on success; throws a
+ * {@link ValidationError} listing the failures otherwise.
+ */
+declare function validateArgs<T = unknown>(schema: JSONSchema, args: unknown): T;
+
+export { validateArgs };

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+export { defineTool } from '../chunk-RZ43WNHR.js';
+export { ToolRegistry, namespacedName, validateArgs } from '../chunk-HGEPXJDG.js';
+import '../chunk-IXV4UIF5.js';
+import '../chunk-DEABART4.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types-Cn1g9Tg4.d.cts

@@ -0,0 +1,63 @@
+/**
+ * Shared content, message, and model-capability types used across the framework.
+ *
+ * These are the lowest-level building blocks: every higher-level module (agents,
+ * providers, tools, workflows) speaks in terms of {@link Message} and
+ * {@link ContentPart}. Keeping them dependency-free keeps the core tree-shakeable.
+ *
+ * @packageDocumentation
+ */
+/** A JSON Schema object (draft 2020-12 compatible), as popularized by MCP. */
+type JSONSchema = Record<string, unknown>;
+/** Role of a message in a conversation. */
+type Role = "system" | "user" | "assistant" | "tool";
+/** A single piece of message content. Images are only valid for vision-capable models. */
+type ContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+/**
+ * A conversation message.
+ *
+ * @example
+ * ```ts
+ * const msg: Message = { role: "user", parts: [{ type: "text", text: "Hi" }] };
+ * ```
+ */
+interface Message {
+    role: Role;
+    parts: ContentPart[];
+    /** Optional tool-call linkage for assistant/tool messages. */
+    toolCallId?: string;
+    /** Optional display name (e.g., the tool name for a tool message). */
+    name?: string;
+}
+/**
+ * Per-model capabilities supplied by the caller. The framework cannot reliably
+ * discover these for arbitrary OpenAI-compatible/LM Studio models, so they are
+ * provided explicitly. (FR-007a)
+ */
+interface ModelCapabilities {
+    /** Model id/name. */
+    model: string;
+    /** Maximum input/context tokens; drives compaction threshold. */
+    maxInputTokens: number;
+    /** Maximum output tokens. */
+    maxOutputTokens: number;
+    /** Whether the model accepts image input. Defaults to false. */
+    supportsVision?: boolean;
+    /** Whether the model emits separate reasoning/thinking content. Defaults to false. */
+    supportsReasoning?: boolean;
+}
+/** Convenience: build a user message from a plain string. */
+declare function textMessage(role: Role, text: string): Message;
+/** Returns true if a message contains any image content part. */
+declare function hasImage(message: Message): boolean;
+/** Extract the concatenated text from a message. */
+declare function messageText(message: Message): string;
+
+export { type ContentPart as C, type JSONSchema as J, type Message as M, type Role as R, type ModelCapabilities as a, hasImage as h, messageText as m, textMessage as t };

package/dist/types-Cn1g9Tg4.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared content, message, and model-capability types used across the framework.
+ *
+ * These are the lowest-level building blocks: every higher-level module (agents,
+ * providers, tools, workflows) speaks in terms of {@link Message} and
+ * {@link ContentPart}. Keeping them dependency-free keeps the core tree-shakeable.
+ *
+ * @packageDocumentation
+ */
+/** A JSON Schema object (draft 2020-12 compatible), as popularized by MCP. */
+type JSONSchema = Record<string, unknown>;
+/** Role of a message in a conversation. */
+type Role = "system" | "user" | "assistant" | "tool";
+/** A single piece of message content. Images are only valid for vision-capable models. */
+type ContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+/**
+ * A conversation message.
+ *
+ * @example
+ * ```ts
+ * const msg: Message = { role: "user", parts: [{ type: "text", text: "Hi" }] };
+ * ```
+ */
+interface Message {
+    role: Role;
+    parts: ContentPart[];
+    /** Optional tool-call linkage for assistant/tool messages. */
+    toolCallId?: string;
+    /** Optional display name (e.g., the tool name for a tool message). */
+    name?: string;
+}
+/**
+ * Per-model capabilities supplied by the caller. The framework cannot reliably
+ * discover these for arbitrary OpenAI-compatible/LM Studio models, so they are
+ * provided explicitly. (FR-007a)
+ */
+interface ModelCapabilities {
+    /** Model id/name. */
+    model: string;
+    /** Maximum input/context tokens; drives compaction threshold. */
+    maxInputTokens: number;
+    /** Maximum output tokens. */
+    maxOutputTokens: number;
+    /** Whether the model accepts image input. Defaults to false. */
+    supportsVision?: boolean;
+    /** Whether the model emits separate reasoning/thinking content. Defaults to false. */
+    supportsReasoning?: boolean;
+}
+/** Convenience: build a user message from a plain string. */
+declare function textMessage(role: Role, text: string): Message;
+/** Returns true if a message contains any image content part. */
+declare function hasImage(message: Message): boolean;
+/** Extract the concatenated text from a message. */
+declare function messageText(message: Message): string;
+
+export { type ContentPart as C, type JSONSchema as J, type Message as M, type Role as R, type ModelCapabilities as a, hasImage as h, messageText as m, textMessage as t };

package/dist/workflows/index.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+var chunkRZP2ZUUX_cjs = require('../chunk-RZP2ZUUX.cjs');
+require('../chunk-MQ2XTH3S.cjs');
+require('../chunk-IJASUMIQ.cjs');
+
+
+
+Object.defineProperty(exports, "CHECKPOINT_VERSION", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.CHECKPOINT_VERSION; }
+});
+Object.defineProperty(exports, "createCheckpoint", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.createCheckpoint; }
+});
+Object.defineProperty(exports, "createWorkflow", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.createWorkflow; }
+});
+Object.defineProperty(exports, "restoreCheckpoint", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.restoreCheckpoint; }
+});
+Object.defineProperty(exports, "runBounded", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.runBounded; }
+});
+Object.defineProperty(exports, "serializeCheckpoint", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.serializeCheckpoint; }
+});
+Object.defineProperty(exports, "stepConcurrent", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.stepConcurrent; }
+});
+Object.defineProperty(exports, "stepGroup", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.stepGroup; }
+});
+Object.defineProperty(exports, "stepHandoff", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.stepHandoff; }
+});
+Object.defineProperty(exports, "stepSequential", {
+  enumerable: true,
+  get: function () { return chunkRZP2ZUUX_cjs.stepSequential; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/workflows/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}