@vextlabs/theron-agent-sdk 0.3.0

package/dist/index.d.cts

@@ -0,0 +1,60 @@
+export { Agent, AgentConfig, AgentInstruction, AgentResult } from './agent/index.cjs';
+export { Council, CouncilConfig, CouncilOutput, Reconciler } from './council/index.cjs';
+export { Session, SessionConfig, SessionEvent } from './session/index.cjs';
+export { InMemoryStore, Memory, MemoryQuery, MemoryRecord } from './memory/index.cjs';
+export { Tool, ToolContext, ToolSchema, defineTool } from './tools/index.cjs';
+export { Verifier, VerifierIssue, VerifierKernels, VerifierResult, defineVerifier } from './verifiers/index.cjs';
+export { ModelAdapter, Runner, RunnerConfig, RunnerEvent } from './runtime/index.cjs';
+export { MCPClient, McpServerConfig, McpTool, collectMcpTools } from './mcp/index.cjs';
+export { TheronAdapterOptions, theron, theronAdapter } from './adapters/theron.cjs';
+export { InMemoryReceiptSink, Receipt, ReceiptEmitter, ReceiptEmitterConfig, ReceiptInput, ReceiptSigner, ReceiptSink, fileReceiptSink, httpReceiptSink } from './receipts/index.cjs';
+export { BoundWorkingSetResult, ChatMessage, CompactHistoryOptions, CompactHistoryResult, ImprovementCycleSpec, ImprovementResult, LoopState, Ratchet, RatchetDecision, RatchetVerdict, RunUntilOptions, RunUntilResult, StopPredicate, WorkingItem, allOf, anyOf, boundWorkingSet, compactHistory, costUsdAtLeast, runImprovementCycle, runUntil, stepCountIs, verifiedRatchet, verifierSatisfied } from './loop/index.cjs';
+export { BestOfNOptions, BestOfNResult, ChainOfVerificationOptions, ChainOfVerificationResult, MeasureLiftOptions, MeasureLiftResult, MixtureOfAgentsOptions, MixtureOfAgentsResult, ReflexionOptions, ReflexionResult, SelfConsistencyOptions, SelfConsistencyResult, SelfRefineOptions, SelfRefineResult, TreeOfThoughtsOptions, TreeOfThoughtsResult, bestOfN, chainOfVerification, measureLift, mixtureOfAgents, reflexion, selfConsistency, selfRefine, treeOfThoughts } from './patterns/index.cjs';
+export { z as zod } from 'zod';
+
+/** OpenAI-compatible function tool definition (same shape as Anthropic via the `tools` field). */
+interface LocalToolDef {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/**
+ * Canonical JSON-Schema `parameters` objects for the 7 shared local tools.
+ *
+ * These are copied verbatim from both theron-cli and theron-vscode (the
+ * parameters blocks are identical across those two packages). Do NOT add
+ * surface-specific prose here — descriptions live per-surface.
+ */
+declare const LOCAL_TOOL_PARAMETERS: Record<string, Record<string, unknown>>;
+/** Registry order for the 7 shared local tools. */
+declare const LOCAL_TOOL_NAMES: readonly string[];
+/**
+ * Tools that can mutate the user's machine.
+ *
+ * Surfaces that add their own tools (e.g. CLI's Stoa, which hits a real SaaS)
+ * should extend this set locally rather than modifying it here.
+ */
+declare const MUTATING_LOCAL_TOOLS: ReadonlySet<string>;
+/**
+ * Build the full OpenAI-style tool schema array for the 7 local tools.
+ *
+ * Each surface supplies its own `descriptions` map (keyed by tool name) so
+ * the prose stays per-runtime (CLI vs VS Code). The shared `parameters` schema
+ * is filled in from `LOCAL_TOOL_PARAMETERS`. A missing description defaults to
+ * an empty string — no throw.
+ *
+ * @example
+ * const schemas = buildLocalToolSchemas({
+ *   Read: "Read a file from the workspace.",
+ *   Write: "Write a file to the workspace.",
+ *   // ...
+ * });
+ */
+declare function buildLocalToolSchemas(descriptions: Record<string, string>): LocalToolDef[];
+
+declare const VERSION = "0.3.0";
+
+export { LOCAL_TOOL_NAMES, LOCAL_TOOL_PARAMETERS, type LocalToolDef, MUTATING_LOCAL_TOOLS, VERSION, buildLocalToolSchemas };

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+export { Agent, AgentConfig, AgentInstruction, AgentResult } from './agent/index.js';
+export { Council, CouncilConfig, CouncilOutput, Reconciler } from './council/index.js';
+export { Session, SessionConfig, SessionEvent } from './session/index.js';
+export { InMemoryStore, Memory, MemoryQuery, MemoryRecord } from './memory/index.js';
+export { Tool, ToolContext, ToolSchema, defineTool } from './tools/index.js';
+export { Verifier, VerifierIssue, VerifierKernels, VerifierResult, defineVerifier } from './verifiers/index.js';
+export { ModelAdapter, Runner, RunnerConfig, RunnerEvent } from './runtime/index.js';
+export { MCPClient, McpServerConfig, McpTool, collectMcpTools } from './mcp/index.js';
+export { TheronAdapterOptions, theron, theronAdapter } from './adapters/theron.js';
+export { InMemoryReceiptSink, Receipt, ReceiptEmitter, ReceiptEmitterConfig, ReceiptInput, ReceiptSigner, ReceiptSink, fileReceiptSink, httpReceiptSink } from './receipts/index.js';
+export { BoundWorkingSetResult, ChatMessage, CompactHistoryOptions, CompactHistoryResult, ImprovementCycleSpec, ImprovementResult, LoopState, Ratchet, RatchetDecision, RatchetVerdict, RunUntilOptions, RunUntilResult, StopPredicate, WorkingItem, allOf, anyOf, boundWorkingSet, compactHistory, costUsdAtLeast, runImprovementCycle, runUntil, stepCountIs, verifiedRatchet, verifierSatisfied } from './loop/index.js';
+export { BestOfNOptions, BestOfNResult, ChainOfVerificationOptions, ChainOfVerificationResult, MeasureLiftOptions, MeasureLiftResult, MixtureOfAgentsOptions, MixtureOfAgentsResult, ReflexionOptions, ReflexionResult, SelfConsistencyOptions, SelfConsistencyResult, SelfRefineOptions, SelfRefineResult, TreeOfThoughtsOptions, TreeOfThoughtsResult, bestOfN, chainOfVerification, measureLift, mixtureOfAgents, reflexion, selfConsistency, selfRefine, treeOfThoughts } from './patterns/index.js';
+export { z as zod } from 'zod';
+
+/** OpenAI-compatible function tool definition (same shape as Anthropic via the `tools` field). */
+interface LocalToolDef {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/**
+ * Canonical JSON-Schema `parameters` objects for the 7 shared local tools.
+ *
+ * These are copied verbatim from both theron-cli and theron-vscode (the
+ * parameters blocks are identical across those two packages). Do NOT add
+ * surface-specific prose here — descriptions live per-surface.
+ */
+declare const LOCAL_TOOL_PARAMETERS: Record<string, Record<string, unknown>>;
+/** Registry order for the 7 shared local tools. */
+declare const LOCAL_TOOL_NAMES: readonly string[];
+/**
+ * Tools that can mutate the user's machine.
+ *
+ * Surfaces that add their own tools (e.g. CLI's Stoa, which hits a real SaaS)
+ * should extend this set locally rather than modifying it here.
+ */
+declare const MUTATING_LOCAL_TOOLS: ReadonlySet<string>;
+/**
+ * Build the full OpenAI-style tool schema array for the 7 local tools.
+ *
+ * Each surface supplies its own `descriptions` map (keyed by tool name) so
+ * the prose stays per-runtime (CLI vs VS Code). The shared `parameters` schema
+ * is filled in from `LOCAL_TOOL_PARAMETERS`. A missing description defaults to
+ * an empty string — no throw.
+ *
+ * @example
+ * const schemas = buildLocalToolSchemas({
+ *   Read: "Read a file from the workspace.",
+ *   Write: "Write a file to the workspace.",
+ *   // ...
+ * });
+ */
+declare function buildLocalToolSchemas(descriptions: Record<string, string>): LocalToolDef[];
+
+declare const VERSION = "0.3.0";
+
+export { LOCAL_TOOL_NAMES, LOCAL_TOOL_PARAMETERS, type LocalToolDef, MUTATING_LOCAL_TOOLS, VERSION, buildLocalToolSchemas };