framework-agents 0.1.0 → 0.1.3

package/dist/index.d.ts

@@ -810,7 +810,7 @@ interface ToolResult {
 interface Tool<TArgs = any, TOutput = any> {
     name: string;
     description: string;
-    schema: z.ZodType<TArgs>;
+    schema: z.ZodType<TArgs, z.ZodTypeDef, any>;
     /** Optional second arg receives ToolContext (state + invocationState). */
     execute: (args: TArgs, ctx?: ToolContext) => Promise<TOutput>;
     /**
@@ -818,10 +818,26 @@ interface Tool<TArgs = any, TOutput = any> {
      * Default: JSON/string content, no artifact. Override to keep raw payloads
      * (retrieval metadata, debug blobs) out of the model's context.
      */
-    toResult?: (output: any) => ToolResult;
+    toResult?: (output: TOutput) => ToolResult;
+}
+/**
+ * The defineTool() input: TSchema drives inference — `execute` receives the
+ * schema's INPUT type (the agent loop passes the model's RAW args; parse
+ * inside `execute` when you need strict validation — no manual generic
+ * annotations needed):
+ *
+ *   defineTool({ schema: z.object({ city: z.string() }),
+ *                execute: async ({ city }) => ... })   // city: string
+ */
+interface ToolSpec<TSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown> {
+    name: string;
+    description: string;
+    schema: TSchema;
+    execute: (args: z.input<TSchema>, ctx?: ToolContext) => Promise<TOutput>;
+    toResult?: (output: TOutput) => ToolResult;
 }
 declare function defaultToResult(output: unknown): ToolResult;
-declare function defineTool<TArgs, TOutput>(tool: Tool<TArgs, TOutput>): Tool<TArgs, TOutput>;
+declare function defineTool<TSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown>(tool: ToolSpec<TSchema, TOutput>): Tool<z.output<TSchema>, TOutput>;
 /** Validating registry — single place tools are looked up + arg-checked. */
 declare class ToolRegistry {
     private tools;
@@ -1613,7 +1629,7 @@ declare class A2AServer {
  * Frontend/server-component client for Framework agents.
  * Framework-agnostic (fetch + async iterators): use directly in TanStack
  * Query loaders, Next.js route handlers/components, Svelte, or plain DOM.
- * React bindings live in @fabisch/react (thin layer over this client).
+ * React bindings live in framework-agents-react (thin layer over this client).
  */
 interface AgentClientOptions {
     fetchFn?: typeof fetch;
@@ -1640,7 +1656,7 @@ declare class AgentClient {
  * `${endpoint}/stream`, so mount this at `app/api/agent/stream/route.ts` and
  * point `useAgent({ endpoint: "/api/agent" })` (or AgentClient) at the parent:
  *
- *   import { AgentClient, handleAgentRoute } from "@fabisch/agents";
+ *   import { AgentClient, handleAgentRoute } from "framework-agents";
  *   const client = new AgentClient(process.env.AGENT_URL!);
  *   export const POST = (req: Request) => handleAgentRoute(req, client);
  *
@@ -1900,8 +1916,8 @@ declare function retrievalTool(retriever: Retriever, opts?: {
     k?: number;
     name?: string;
 }): Tool<{
+    k: number;
     query: string;
-    k?: number | undefined;
 }, ScoredDoc[]>;
 /** SPARQL-backed retriever: keyword match over the closure, rendered as text. */
 declare function sparqlRetriever(store: {
@@ -2356,8 +2372,8 @@ declare class EntityLinker {
 }
 /** link_entity agent tool: mention -> canonical IRIs with scores. */
 declare function linkEntityTool(linker: EntityLinker): Tool<{
+    k: number;
     mention: string;
-    k?: number | undefined;
 }, LinkedEntity[]>;
 interface MappingProposal {
     id: string;
@@ -2725,7 +2741,7 @@ declare function sparqlSelectTool(store: GraphStore): Tool<{
 /** Ontology lookup: find classes/properties/labels matching a term. */
 declare function ontologyLookupTool(store: GraphStore): Tool<{
     term: string;
-    limit?: number | undefined;
+    limit: number;
 }, {
     subject: string;
     predicate: string;
@@ -2839,4 +2855,4 @@ declare function estimateCostUsd(usage: {
     outputPerMillion: number;
 }): number;
 
-export { A2AClient, type A2AClientOptions, A2AServer, type A2AServerOptions, Agent, type AgentCard, AgentClient, type AgentClientOptions, AgentError, type AgentEvents, type AgentId, type AgentMiddleware, type AgentOptions, type AgentResult, AgentState, type AnthropicOptions, AnthropicProvider, type AnyMcpClient, AudioBlockSchema, type BackoffOptions, type Brand, type Budget, type ChatMessage, ChatMessageSchema, type Checkpointer, type ClaimVerdict, ClearToolUsesEdit, type ClearToolUsesOptions, CompactedMemory, type CompactionOptions, type CompleteOptions, type ConformanceCheck, type ConformanceReport, type ConformanceResult, type ConsoleEventsOptions, ConsoleSpanSink, type ContentBlock, ContentBlockSchema, type ConversationManager, type DoneEvent, EntityLinker, type EvalCase, type EvalExpect, type EvalScore, type ExecutedToolCall, FileBlockSchema, FileCheckpointer, FileMemory, type FrameworkConfig, type FrameworkFile, FrameworkFileSchema, GraphMemory, type GraphRule, type GraphStore, type HandoffSignal, type HitlDecideRequest, type HitlDecision, HitlInterrupt, type HookContext, type ImageBlock, ImageBlockSchema, InMemoryGraphStore, InMemoryMemory, InMemoryRetriever, InMemoryStorage, type InvocationState, JSONLD_PREFIXES, JsonlSpanSink, LABEL_PREDICATES, type LinkedEntity, type LoadedFrameworkFile, LocalFileStorage, type MappingDecision, type MappingProposal, MappingProposals, type MappingProposalsOptions, type McpClient, type McpClientOptions, McpHttpClient, McpStdioClient, type McpToolDef, type Memory, MemorySpanSink, type MigrationReport, type MigrationResult, MockModelProvider, type ModelCapability, type ModelCompletion, type ModelPrice, type ModelProvider, type ModelRequest, type NodeShape, NonStandardBlockSchema, NullConversationManager, OWL_VOCAB, type OllamaOptions, OllamaProvider, type OntologyReview, type OpenAICompatibleOptions, OpenAICompatibleProvider, type OrchestratedResult, type OrchestrationPlan, type OrchestrationStrategy, type OutputVersion, type PIIDetector, type PIIMatch, type PIIStrategy, type PatternBinding, type PromptTemplate, type PropertyShape, type Quad, type ReasoningBlock, ReasoningBlockSchema, RemoteSparqlAdapter, type RemoteSparqlOptions, type ResolvedAgentDef, type ResponseFormat, type ResponseFormatWire, type ResponseStrategy, type Result, type Retriever, type RetryFilter, type RetryMiddlewareOptions, type RunId, type RunOptions, type SandboxBackend, type SandboxOptions, type ScoredDoc, type ServedAgent, SessionManager, type SessionManagerOptions, type ShapeInductionOptions, type ShapeReport, type Skill, type SkillLoaderOptions, SkillRegistry, SlidingWindowConversationManager, type SlidingWindowOptions, type Snapshot, type SnapshotData, type SnapshotField, type Span, type SpanSink, type SparqlAuth, type SparqlRow, type SparqlSelect, type StepEvent, type Storage, type StoreOptions, type StreamEvent, SummarizingConversationManager, type SummarizingOptions, Swarm, type SwarmOptions, type SwarmResult, type SwarmStatus, type SwarmStreamEvent, TBOX_PREDICATES, type TBoxMigrationSpec, type TakeSnapshotOptions, type TermStat, type TextBlock, TextBlockSchema, type ThreadCheckpoint, type TimelineEntry, type TodoItem, type TokenBudgets, type TokenUsage, type Tool, ToolCallBlockSchema, type ToolCallEvent, type ToolCallRef, type ToolCallRequest, type ToolContext, type ToolName, ToolRegistry, ToolRejection, type ToolResult, type ToolResultEvent, type TriplePattern, TurtleQuadSchema, type WorkflowNode, type WorkflowOptions, __resetConfig, a2aAsTool, abPrompts, adoptShapes, assertCanHandle, assistant, backoffDelayMs, buildServedAgent, claimCheckTool, collectStream, connectMcpHttp, connectMcpStdio, consoleEvents, contextEditingMiddleware, createMiddleware, createSandboxBackend, createSubAgentMiddleware, defaultSummarize, defaultToResult, definePrompt, defineTool, deserializeMessages, discoverSkills, estimateCostUsd, estimateTokens, executeSelect, filesystemMiddleware, filesystemTools, getRetryable, graphAddTool, handleAgentRoute, hasImages, historyTokens, hitlKey, humanInTheLoopMiddleware, imagesOf, initChatModel, instantiate, jsonSchemaToZod, jsonldToQuads, linkEntityTool, llmToolSelectorMiddleware, loadConfig, loadEnvFile, loadFrameworkConfig, loadJsonl, loadPromptFile, loadSkillsInto, logError, matchGlob, matchPatterns, matchSkills, mcpToolsToFramework, messageTokens, migrateTBox, modelCallLimit, modelFallbackMiddleware, modelRetryMiddleware, ollama, ontologyLookupTool, parseSelect, parseSkillFile, parseStructured, piiMiddleware, policyFilterMiddleware, priceFor, printReport, proposeMappingTool, proposeShapes, proposeShapesTool, providerFromEnv, providerStrategy, quadsToJsonLd, readHandoffSignal, remoteSparqlTool, responseFormatJsonSchema, responseFormatName, retrievalTool, reviewOntology, reviewOntologyTool, runConformance, runEval, runJavascriptTool, runOrchestrated, runWithBudget, runWorkflow, scoreSkills, selectSnapshotFields, serializeMessages, serveFramework, sleep, sparqlRetriever, sparqlSelectTool, stampRetryable, summarizationMiddleware, supportsColor, supportsVision, system, textOf, todoListMiddleware, tokenize, toolCallLimitMiddleware, toolEmulatorMiddleware, toolResult, toolRetry, toolRetryMiddleware, toolStrategy, tracingEvents, trimDangling, usageCost, user, wireTextOf, withFileLock };
+export { A2AClient, type A2AClientOptions, A2AServer, type A2AServerOptions, Agent, type AgentCard, AgentClient, type AgentClientOptions, AgentError, type AgentEvents, type AgentId, type AgentMiddleware, type AgentOptions, type AgentResult, AgentState, type AnthropicOptions, AnthropicProvider, type AnyMcpClient, AudioBlockSchema, type BackoffOptions, type Brand, type Budget, type ChatMessage, ChatMessageSchema, type Checkpointer, type ClaimVerdict, ClearToolUsesEdit, type ClearToolUsesOptions, CompactedMemory, type CompactionOptions, type CompleteOptions, type ConformanceCheck, type ConformanceReport, type ConformanceResult, type ConsoleEventsOptions, ConsoleSpanSink, type ContentBlock, ContentBlockSchema, type ConversationManager, type DoneEvent, EntityLinker, type EvalCase, type EvalExpect, type EvalScore, type ExecutedToolCall, FileBlockSchema, FileCheckpointer, FileMemory, type FrameworkConfig, type FrameworkFile, FrameworkFileSchema, GraphMemory, type GraphRule, type GraphStore, type HandoffSignal, type HitlDecideRequest, type HitlDecision, HitlInterrupt, type HookContext, type ImageBlock, ImageBlockSchema, InMemoryGraphStore, InMemoryMemory, InMemoryRetriever, InMemoryStorage, type InvocationState, JSONLD_PREFIXES, JsonlSpanSink, LABEL_PREDICATES, type LinkedEntity, type LoadedFrameworkFile, LocalFileStorage, type MappingDecision, type MappingProposal, MappingProposals, type MappingProposalsOptions, type McpClient, type McpClientOptions, McpHttpClient, McpStdioClient, type McpToolDef, type Memory, MemorySpanSink, type MigrationReport, type MigrationResult, MockModelProvider, type ModelCapability, type ModelCompletion, type ModelPrice, type ModelProvider, type ModelRequest, type NodeShape, NonStandardBlockSchema, NullConversationManager, OWL_VOCAB, type OllamaOptions, OllamaProvider, type OntologyReview, type OpenAICompatibleOptions, OpenAICompatibleProvider, type OrchestratedResult, type OrchestrationPlan, type OrchestrationStrategy, type OutputVersion, type PIIDetector, type PIIMatch, type PIIStrategy, type PatternBinding, type PromptTemplate, type PropertyShape, type Quad, type ReasoningBlock, ReasoningBlockSchema, RemoteSparqlAdapter, type RemoteSparqlOptions, type ResolvedAgentDef, type ResponseFormat, type ResponseFormatWire, type ResponseStrategy, type Result, type Retriever, type RetryFilter, type RetryMiddlewareOptions, type RunId, type RunOptions, type SandboxBackend, type SandboxOptions, type ScoredDoc, type ServedAgent, SessionManager, type SessionManagerOptions, type ShapeInductionOptions, type ShapeReport, type Skill, type SkillLoaderOptions, SkillRegistry, SlidingWindowConversationManager, type SlidingWindowOptions, type Snapshot, type SnapshotData, type SnapshotField, type Span, type SpanSink, type SparqlAuth, type SparqlRow, type SparqlSelect, type StepEvent, type Storage, type StoreOptions, type StreamEvent, SummarizingConversationManager, type SummarizingOptions, Swarm, type SwarmOptions, type SwarmResult, type SwarmStatus, type SwarmStreamEvent, TBOX_PREDICATES, type TBoxMigrationSpec, type TakeSnapshotOptions, type TermStat, type TextBlock, TextBlockSchema, type ThreadCheckpoint, type TimelineEntry, type TodoItem, type TokenBudgets, type TokenUsage, type Tool, ToolCallBlockSchema, type ToolCallEvent, type ToolCallRef, type ToolCallRequest, type ToolContext, type ToolName, ToolRegistry, ToolRejection, type ToolResult, type ToolResultEvent, type ToolSpec, type TriplePattern, TurtleQuadSchema, type WorkflowNode, type WorkflowOptions, __resetConfig, a2aAsTool, abPrompts, adoptShapes, assertCanHandle, assistant, backoffDelayMs, buildServedAgent, claimCheckTool, collectStream, connectMcpHttp, connectMcpStdio, consoleEvents, contextEditingMiddleware, createMiddleware, createSandboxBackend, createSubAgentMiddleware, defaultSummarize, defaultToResult, definePrompt, defineTool, deserializeMessages, discoverSkills, estimateCostUsd, estimateTokens, executeSelect, filesystemMiddleware, filesystemTools, getRetryable, graphAddTool, handleAgentRoute, hasImages, historyTokens, hitlKey, humanInTheLoopMiddleware, imagesOf, initChatModel, instantiate, jsonSchemaToZod, jsonldToQuads, linkEntityTool, llmToolSelectorMiddleware, loadConfig, loadEnvFile, loadFrameworkConfig, loadJsonl, loadPromptFile, loadSkillsInto, logError, matchGlob, matchPatterns, matchSkills, mcpToolsToFramework, messageTokens, migrateTBox, modelCallLimit, modelFallbackMiddleware, modelRetryMiddleware, ollama, ontologyLookupTool, parseSelect, parseSkillFile, parseStructured, piiMiddleware, policyFilterMiddleware, priceFor, printReport, proposeMappingTool, proposeShapes, proposeShapesTool, providerFromEnv, providerStrategy, quadsToJsonLd, readHandoffSignal, remoteSparqlTool, responseFormatJsonSchema, responseFormatName, retrievalTool, reviewOntology, reviewOntologyTool, runConformance, runEval, runJavascriptTool, runOrchestrated, runWithBudget, runWorkflow, scoreSkills, selectSnapshotFields, serializeMessages, serveFramework, sleep, sparqlRetriever, sparqlSelectTool, stampRetryable, summarizationMiddleware, supportsColor, supportsVision, system, textOf, todoListMiddleware, tokenize, toolCallLimitMiddleware, toolEmulatorMiddleware, toolResult, toolRetry, toolRetryMiddleware, toolStrategy, tracingEvents, trimDangling, usageCost, user, wireTextOf, withFileLock };

package/dist/index.js

@@ -71,7 +71,7 @@ import {
   usageCost,
   user,
   wireTextOf
-} from "./chunk-77OZE2QD.js";
+} from "./chunk-VIGLIWEY.js";
 
 // src/config/index.ts
 import { existsSync } from "fs";
@@ -2246,7 +2246,7 @@ var McpHttpClient = class {
     this.serverId = opts.serverId ?? url;
     this.headers = opts.headers ?? {};
     this.fetchFn = opts.fetchFn ?? fetch;
-    this.clientName = opts.clientName ?? "fabisch-agents";
+    this.clientName = opts.clientName ?? "framework-agents";
   }
   async rpc(method, params) {
     return this.rpcInner(method, params, true);
@@ -2317,7 +2317,7 @@ var McpStdioClient = class {
     this.command = command;
     this.args = args;
     this.serverId = opts.serverId ?? `${command} ${args.join(" ")}`.trim();
-    this.clientName = opts.clientName ?? "fabisch-agents";
+    this.clientName = opts.clientName ?? "framework-agents";
   }
   command;
   args;
@@ -3064,7 +3064,7 @@ async function migrateTBox(oldStore, spec, opts = {}) {
     rules: spec.rules ?? oldStore.ontologyRules()
   });
   const explicit = (await oldStore.match(null, null, null)).filter((q) => q.source !== "entailment");
-  const tboxGraph = opts.tboxGraph === false ? void 0 : opts.tboxGraph ?? `urn:fabisch:ontology:${spec.to}`;
+  const tboxGraph = opts.tboxGraph === false ? void 0 : opts.tboxGraph ?? `urn:framework:ontology:${spec.to}`;
   report.tboxGraph = tboxGraph;
   const isAxiom = (q, predicatesInUse2) => {
     if (TBOX_PREDICATES.has(q.predicate)) return true;