agentified 0.0.4

package/README.md

@@ -0,0 +1,190 @@
+# @agentified/sdk
+
+Register 200 tools. Get the 5 that matter.
+
+TypeScript SDK for [Agentified](../../../README.md) — register tools, discover relevant ones via [hybrid ranking](../../../docs/concepts/ranking.md), and track [sessions](../../../docs/concepts/session-continuity.md) across turns.
+
+## Install
+
+```bash
+npm install @agentified/sdk
+```
+
+## Quick Start
+
+```typescript
+import { ApiClient, tool } from "@agentified/sdk";
+
+const agent = new ApiClient({
+  serverUrl: "http://localhost:9119",
+  tools: [
+    tool({ name: "get_weather", description: "Get current weather", parameters: { type: "object", properties: { city: { type: "string" } }, required: ["city"] } }),
+    tool({ name: "book_flight", description: "Book a flight", parameters: { type: "object", properties: { from: { type: "string" }, to: { type: "string" } }, required: ["from", "to"] } }),
+  ],
+});
+
+await agent.register();
+
+const ranked = await agent.prefetch({
+  messages: [{ role: "user", content: "What's the weather in Rome?" }],
+});
+// → [{ name: "get_weather", score: 0.92, ... }, ...]
+```
+
+## API Reference
+
+### `tool(definition)`
+
+Creates a `ServerTool` with auto-populated `fields` for embedding.
+
+```typescript
+import { tool } from "@agentified/sdk";
+
+const t = tool({
+  name: "search_docs",
+  description: "Search documentation by keyword",
+  parameters: { type: "object", properties: { query: { type: "string" } }, required: ["query"] },
+  metadata: { category: "search" }, // optional
+});
+```
+
+### `new ApiClient(config)`
+
+```typescript
+interface ApiClientConfig {
+  serverUrl: string;
+  tools: ServerTool[];
+  onEvent?: (event: AgentifiedEvent) => void;
+}
+```
+
+### `agent.register()`
+
+Registers all tools with the server. Embeddings are computed and cached server-side.
+
+```typescript
+const result = await agent.register();
+// { registered: 10 }
+```
+
+### `agent.prefetch(options)`
+
+Discovers relevant tools for a conversation. Joins all message contents (newline-separated) as the discovery query.
+
+```typescript
+interface PrefetchOptions {
+  messages: Message[];
+  limit?: number;       // default 5
+  exclude?: string[];
+  turnId?: string;      // for session continuity
+}
+
+const tools = await agent.prefetch({
+  messages: [{ role: "user", content: "Book me a flight to Paris" }],
+  limit: 10,
+  exclude: ["admin_tool"],
+  turnId: "prev-turn-id",
+});
+```
+
+### `agent.captureTurn(options)`
+
+Captures a turn for session continuity. The returned `turnId` can be passed to subsequent `prefetch`/`discover` calls.
+
+```typescript
+const { turnId } = await agent.captureTurn({
+  toolsLoaded: ["get_weather", "book_flight"],
+  message: "What's the weather in Rome?",
+});
+```
+
+### `agent.getFrontendTools()`
+
+Returns tools with `metadata.location === "frontend"`.
+
+```typescript
+const frontendTools = agent.getFrontendTools();
+```
+
+### `agent.getFrontendToolNames()`
+
+Returns names of frontend tools.
+
+```typescript
+const names = agent.getFrontendToolNames();
+// ["navigate_to_page", "open_modal"]
+```
+
+### `agent.asDiscoverTool()`
+
+Returns a tool definition + execute function for `agentified_discover` — useful for giving the agent a tool that can discover more tools at runtime.
+
+```typescript
+const { definition, execute } = agent.asDiscoverTool();
+// definition: { name: "agentified_discover", description: "...", parameters: { ... } }
+// execute({ query: "...", limit: 5 }) → Promise<RankedTool[]>
+```
+
+## Events
+
+Subscribe to lifecycle events via `onEvent` in the config:
+
+```typescript
+const agent = new ApiClient({
+  serverUrl: "http://localhost:9119",
+  tools: [...],
+  onEvent: (event) => {
+    switch (event.type) {
+      case "agentified:prefetch:start":    // { messages }
+      case "agentified:prefetch:complete": // { tools, durationMs, tokenUsage? }
+      case "agentified:prefetch:skipped":  // { tools, durationMs }
+      case "agentified:discover:start":    // { query }
+      case "agentified:discover:complete": // { query, tools, durationMs, tokenUsage? }
+    }
+  },
+});
+```
+
+## Types
+
+```typescript
+interface ServerTool {
+  name: string;
+  description: string;
+  parameters: Record<string, unknown>;
+  metadata?: Record<string, unknown>;
+  fields?: { name: string; description: string; inputSchema?: string; outputSchema?: string };
+}
+
+interface RankedTool extends ServerTool {
+  score: number;
+  graphExpanded?: boolean;
+}
+
+interface Message {
+  role: string;
+  content: string;
+}
+
+interface TokenUsage {
+  input: number;
+  output: number;
+  cached: number;
+  reasoning: number;
+}
+```
+
+## Links
+
+- [Root README](../../../README.md)
+- [Documentation](../../../docs/)
+- [Architecture](../../../docs/architecture.md)
+- [agentified-core](../../core/README.md)
+- [Frontend Client](../fe-client/README.md)
+- [React Bindings](../react/README.md)
+- [Mastra Adapter](../mastra/README.md)
+- [Python SDK](../../py-packages/sdk/README.md)
+
+## License
+
+[MIT](../../../LICENSE.md#mit-license)

package/dist/agentified.d.ts

@@ -0,0 +1,17 @@
+import type { ApiClientConfig, AppendMessagesResponse, CaptureTurnOptions, CaptureTurnResponse, ContextOpts, ContextResponse, DiscoverTool, GetMessagesOpts, GetMessagesResponse, Message, PrefetchOptions, RankedTool, RegisterResponse, ServerTool } from "./types.js";
+export declare class ApiClient {
+    private config;
+    constructor(config: ApiClientConfig);
+    register(datasetId: string): Promise<RegisterResponse>;
+    discover(datasetId: string, query: string, limit?: number, exclude?: string[], turnId?: string): Promise<RankedTool[]>;
+    prefetch(datasetId: string, options: PrefetchOptions): Promise<RankedTool[]>;
+    captureTurn(namespace: string, session: string, options: CaptureTurnOptions): Promise<CaptureTurnResponse>;
+    appendMessages(dataset: string, namespace: string, session: string, messages: Message[]): Promise<AppendMessagesResponse>;
+    getMessages(dataset: string, namespace: string, session: string, opts?: GetMessagesOpts): Promise<GetMessagesResponse>;
+    getContext(dataset: string, namespace: string, session: string, opts?: ContextOpts): Promise<ContextResponse>;
+    getFrontendTools(): ServerTool[];
+    getFrontendToolNames(): string[];
+    asDiscoverTool(datasetId: string): DiscoverTool;
+    private emit;
+}
+//# sourceMappingURL=agentified.d.ts.map

package/dist/agentified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentified.d.ts","sourceRoot":"","sources":["../src/agentified.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,eAAe,EAEf,YAAY,EAEZ,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAI7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAStD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwBtH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAe5E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAe1G,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAUzH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAyBtH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAwCnH,gBAAgB,IAAI,UAAU,EAAE;IAIhC,oBAAoB,IAAI,MAAM,EAAE;IAIhC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IA+B/C,OAAO,CAAC,IAAI;CAGb"}

package/dist/agentified.js

@@ -0,0 +1,169 @@
+export class ApiClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async register(datasetId) {
+        const res = await fetch(`${this.config.serverUrl}/api/v1/datasets/${datasetId}/tools`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ tools: this.config.tools }),
+        });
+        return res.json();
+    }
+    async discover(datasetId, query, limit, exclude, turnId) {
+        const body = { query };
+        if (limit !== undefined)
+            body.limit = limit;
+        if (exclude !== undefined)
+            body.exclude = exclude;
+        if (turnId !== undefined)
+            body.turn_id = turnId;
+        const res = await fetch(`${this.config.serverUrl}/api/v1/datasets/${datasetId}/discover`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        const data = (await res.json());
+        const tools = data.tools ?? [];
+        if (this.config.tools.length > 0) {
+            const registered = new Set(this.config.tools.map((t) => t.name));
+            for (const tool of tools) {
+                if (!registered.has(tool.name)) {
+                    throw new Error(`Discovered tool '${tool.name}' is not registered in the SDK. Register it before use.`);
+                }
+            }
+        }
+        return tools;
+    }
+    async prefetch(datasetId, options) {
+        this.emit({ type: "agentified:prefetch:start", messages: options.messages });
+        const start = performance.now();
+        const query = options.messages.map((m) => m.content).join("\n");
+        const tools = await this.discover(datasetId, query, options.limit, options.exclude, options.turnId);
+        this.emit({
+            type: "agentified:prefetch:complete",
+            tools,
+            durationMs: performance.now() - start,
+        });
+        return tools;
+    }
+    async captureTurn(namespace, session, options) {
+        const res = await fetch(`${this.config.serverUrl}/api/v1/turns`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                namespace_id: namespace,
+                session_id: session,
+                tools_loaded: options.toolsLoaded,
+                message: options.message,
+            }),
+        });
+        const data = (await res.json());
+        return { turnId: data.turn_id };
+    }
+    async appendMessages(dataset, namespace, session, messages) {
+        const res = await fetch(`${this.config.serverUrl}/api/v1/messages`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ dataset, namespace, session, messages }),
+        });
+        const data = (await res.json());
+        return { appended: data.appended, firstSeq: data.first_seq, lastSeq: data.last_seq };
+    }
+    async getMessages(dataset, namespace, session, opts) {
+        const params = new URLSearchParams({ dataset, namespace, session });
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.afterSeq !== undefined)
+            params.set("after_seq", String(opts.afterSeq));
+        if (opts?.aroundSeq !== undefined)
+            params.set("around_seq", String(opts.aroundSeq));
+        const res = await fetch(`${this.config.serverUrl}/api/v1/messages?${params}`, {
+            method: "GET",
+        });
+        const data = (await res.json());
+        return {
+            messages: data.messages.map((m) => ({
+                id: m.id,
+                role: m.role,
+                content: m.content,
+                toolCallId: m.tool_call_id,
+                toolCalls: m.tool_calls,
+                createdAt: m.created_at,
+                seq: m.seq,
+            })),
+            hasMore: data.has_more,
+            maxSeq: data.max_seq,
+        };
+    }
+    async getContext(dataset, namespace, session, opts) {
+        const messagesConfig = {};
+        if (opts?.strategy !== undefined)
+            messagesConfig.strategy = opts.strategy;
+        if (opts?.maxTokens !== undefined)
+            messagesConfig.max_tokens = opts.maxTokens;
+        const res = await fetch(`${this.config.serverUrl}/api/v1/context`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ dataset, namespace, session, messages: messagesConfig }),
+        });
+        const data = (await res.json());
+        return {
+            messages: data.messages.map((m) => ({
+                id: m.id,
+                role: m.role,
+                content: m.content,
+                toolCallId: m.tool_call_id,
+                toolCalls: m.tool_calls,
+                createdAt: m.created_at,
+                seq: m.seq,
+            })),
+            strategyUsed: data.strategy_used,
+            totalMessages: data.total_messages,
+            includedMessages: data.included_messages,
+            recalled: data.recalled,
+            tokenEstimate: data.token_estimate,
+            conversationMessages: data.conversation_messages,
+            fallback: data.fallback,
+        };
+    }
+    getFrontendTools() {
+        return this.config.tools.filter((t) => t.metadata?.location === "frontend");
+    }
+    getFrontendToolNames() {
+        return this.getFrontendTools().map((t) => t.name);
+    }
+    asDiscoverTool(datasetId) {
+        return {
+            definition: {
+                name: "agentified_discover",
+                description: "Find tools relevant to the current task. Call this when you need capabilities you don't have.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string", description: "Natural language description of what you need to do" },
+                        limit: { type: "number", description: "Max number of tools to return" },
+                    },
+                    required: ["query"],
+                },
+            },
+            execute: async (input) => {
+                this.emit({ type: "agentified:discover:start", query: input.query });
+                const start = performance.now();
+                const tools = await this.discover(datasetId, input.query, input.limit);
+                this.emit({
+                    type: "agentified:discover:complete",
+                    query: input.query,
+                    tools,
+                    durationMs: performance.now() - start,
+                });
+                return tools;
+            },
+        };
+    }
+    emit(event) {
+        this.config.onEvent?.(event);
+    }
+}
+//# sourceMappingURL=agentified.js.map

package/dist/agentified.js.map

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

package/dist/index.cjs

@@ -0,0 +1,130 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Agentified: () => Agentified,
+  tool: () => tool
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/agentified.ts
+var Agentified = class {
+  serverUrl;
+  constructor(config) {
+    this.serverUrl = config.serverUrl.replace(/\/+$/, "");
+  }
+  async register(tools) {
+    const serverTools = tools.map(toServerTool);
+    const res = await fetch(`${this.serverUrl}/api/v1/tools`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ tools: serverTools })
+    });
+    if (!res.ok) {
+      const body = await res.json();
+      throw new Error(body.error ?? `register failed (${res.status})`);
+    }
+    return res.json();
+  }
+  async prefetch(options) {
+    const lastUserMsg = [...options.messages].reverse().find((m) => m.role === "user");
+    if (!lastUserMsg) return { tools: [] };
+    return this.discover(lastUserMsg.content, options.topK ?? 10);
+  }
+  asDiscoverTool(options) {
+    const limit = options?.topK ?? 10;
+    return {
+      name: "discover_tools",
+      description: "Discover relevant tools by semantic search. Provide a query string or multiple queries.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "A single search query to find relevant tools"
+          },
+          queries: {
+            type: "array",
+            items: { type: "string" },
+            description: "Multiple search queries to find relevant tools (results merged and deduplicated)"
+          }
+        }
+      },
+      execute: async (input) => {
+        if (input.queries) {
+          const results = await Promise.all(
+            input.queries.map((q) => this.discover(q, limit))
+          );
+          return dedupeByName(results.flatMap((r) => r.tools));
+        }
+        const { tools } = await this.discover(input.query ?? "", limit);
+        return tools;
+      }
+    };
+  }
+  async discover(query, limit) {
+    const res = await fetch(`${this.serverUrl}/api/v1/discover`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ query, limit })
+    });
+    if (!res.ok) {
+      const body = await res.json();
+      throw new Error(body.error ?? `discover failed (${res.status})`);
+    }
+    return res.json();
+  }
+};
+function dedupeByName(tools) {
+  const map = /* @__PURE__ */ new Map();
+  for (const t of tools) {
+    const existing = map.get(t.name);
+    if (!existing || t.score > existing.score) map.set(t.name, t);
+  }
+  return [...map.values()];
+}
+function toServerTool(def) {
+  const fields = {
+    name: def.name,
+    description: def.description
+  };
+  if (def.inputSchema) fields.input_schema = JSON.stringify(def.inputSchema);
+  if (def.outputSchema) fields.output_schema = JSON.stringify(def.outputSchema);
+  const tool2 = {
+    name: def.name,
+    description: def.description,
+    parameters: def.inputSchema ?? {},
+    fields
+  };
+  if (def.metadata) tool2.metadata = def.metadata;
+  return tool2;
+}
+
+// src/tool.ts
+function tool(definition) {
+  return { ...definition };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Agentified,
+  tool
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/agentified.ts","../src/tool.ts"],"sourcesContent":["export { Agentified } from \"./agentified.js\";\nexport { tool } from \"./tool.js\";\nexport type {\n  AgentifiedConfig,\n  DiscoverRequest,\n  DiscoverResponse,\n  DiscoverTool,\n  DiscoverToolInput,\n  Message,\n  PrefetchOptions,\n  RankedTool,\n  RegisterRequest,\n  RegisterResponse,\n  ServerTool,\n  ServerToolFields,\n  ToolDefinition,\n} from \"./types.js\";\n","import type {\n  AgentifiedConfig,\n  DiscoverResponse,\n  DiscoverTool,\n  DiscoverToolInput,\n  PrefetchOptions,\n  RankedTool,\n  ToolDefinition,\n  RegisterResponse,\n  ServerTool,\n  ServerToolFields,\n} from \"./types.js\";\n\nexport class Agentified {\n  private serverUrl: string;\n\n  constructor(config: AgentifiedConfig) {\n    this.serverUrl = config.serverUrl.replace(/\\/+$/, \"\");\n  }\n\n  async register(tools: ToolDefinition[]): Promise<RegisterResponse> {\n    const serverTools = tools.map(toServerTool);\n    const res = await fetch(`${this.serverUrl}/api/v1/tools`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ tools: serverTools }),\n    });\n    if (!res.ok) {\n      const body = (await res.json()) as { error?: string };\n      throw new Error(body.error ?? `register failed (${res.status})`);\n    }\n    return res.json() as Promise<RegisterResponse>;\n  }\n\n  async prefetch(options: PrefetchOptions): Promise<DiscoverResponse> {\n    const lastUserMsg = [...options.messages]\n      .reverse()\n      .find((m) => m.role === \"user\");\n    if (!lastUserMsg) return { tools: [] };\n\n    return this.discover(lastUserMsg.content, options.topK ?? 10);\n  }\n\n  asDiscoverTool(options?: { topK?: number }): DiscoverTool {\n    const limit = options?.topK ?? 10;\n    return {\n      name: \"discover_tools\",\n      description:\n        \"Discover relevant tools by semantic search. Provide a query string or multiple queries.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          query: {\n            type: \"string\",\n            description: \"A single search query to find relevant tools\",\n          },\n          queries: {\n            type: \"array\",\n            items: { type: \"string\" },\n            description:\n              \"Multiple search queries to find relevant tools (results merged and deduplicated)\",\n          },\n        },\n      },\n      execute: async (input: DiscoverToolInput): Promise<RankedTool[]> => {\n        if (input.queries) {\n          const results = await Promise.all(\n            input.queries.map((q) => this.discover(q, limit))\n          );\n          return dedupeByName(results.flatMap((r) => r.tools));\n        }\n        const { tools } = await this.discover(input.query ?? \"\", limit);\n        return tools;\n      },\n    };\n  }\n\n  private async discover(\n    query: string,\n    limit: number\n  ): Promise<DiscoverResponse> {\n    const res = await fetch(`${this.serverUrl}/api/v1/discover`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ query, limit }),\n    });\n    if (!res.ok) {\n      const body = (await res.json()) as { error?: string };\n      throw new Error(body.error ?? `discover failed (${res.status})`);\n    }\n    return res.json() as Promise<DiscoverResponse>;\n  }\n}\n\nfunction dedupeByName(tools: RankedTool[]): RankedTool[] {\n  const map = new Map<string, RankedTool>();\n  for (const t of tools) {\n    const existing = map.get(t.name);\n    if (!existing || t.score > existing.score) map.set(t.name, t);\n  }\n  return [...map.values()];\n}\n\nfunction toServerTool(def: ToolDefinition): ServerTool {\n  const fields: ServerToolFields = {\n    name: def.name,\n    description: def.description,\n  };\n  if (def.inputSchema) fields.input_schema = JSON.stringify(def.inputSchema);\n  if (def.outputSchema) fields.output_schema = JSON.stringify(def.outputSchema);\n\n  const tool: ServerTool = {\n    name: def.name,\n    description: def.description,\n    parameters: def.inputSchema ?? {},\n    fields,\n  };\n  if (def.metadata) tool.metadata = def.metadata;\n  return tool;\n}\n","import type { ToolDefinition } from \"./types.js\";\n\nexport function tool(definition: ToolDefinition): ToolDefinition {\n  return { ...definition };\n}\n"],"mappings":"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","names":["tool"]}

package/dist/index.d.cts

@@ -0,0 +1,72 @@
+interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface ServerToolFields {
+    name: string;
+    description: string;
+    input_schema?: string;
+    output_schema?: string;
+}
+interface ServerTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    fields?: ServerToolFields;
+}
+interface RegisterRequest {
+    tools: ServerTool[];
+}
+interface RegisterResponse {
+    registered: number;
+}
+interface DiscoverRequest {
+    query: string;
+    limit?: number;
+}
+interface RankedTool extends ServerTool {
+    score: number;
+}
+interface DiscoverResponse {
+    tools: RankedTool[];
+}
+interface AgentifiedConfig {
+    serverUrl: string;
+}
+interface Message {
+    role: string;
+    content: string;
+}
+interface PrefetchOptions {
+    messages: Message[];
+    topK?: number;
+}
+interface DiscoverToolInput {
+    query?: string;
+    queries?: string[];
+}
+interface DiscoverTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: (input: DiscoverToolInput) => Promise<RankedTool[]>;
+}
+
+declare class Agentified {
+    private serverUrl;
+    constructor(config: AgentifiedConfig);
+    register(tools: ToolDefinition[]): Promise<RegisterResponse>;
+    prefetch(options: PrefetchOptions): Promise<DiscoverResponse>;
+    asDiscoverTool(options?: {
+        topK?: number;
+    }): DiscoverTool;
+    private discover;
+}
+
+declare function tool(definition: ToolDefinition): ToolDefinition;
+
+export { Agentified, type AgentifiedConfig, type DiscoverRequest, type DiscoverResponse, type DiscoverTool, type DiscoverToolInput, type Message, type PrefetchOptions, type RankedTool, type RegisterRequest, type RegisterResponse, type ServerTool, type ServerToolFields, type ToolDefinition, tool };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { ApiClient } from "./agentified.js";
+/** @deprecated Use ApiClient instead */
+export { ApiClient as Agentified } from "./agentified.js";
+export { tool } from "./tool.js";
+export type { ApiClientConfig, AgentifiedEvent, AppendMessagesResponse, CaptureTurnOptions, CaptureTurnResponse, ContextOpts, ContextResponse, DiscoverResponse, DiscoverTool, DiscoverToolInput, GetMessagesOpts, GetMessagesResponse, Message, PrefetchOptions, RankedTool, RegisterRequest, RegisterResponse, ServerTool, ServerToolFields, StoredMessage, TokenUsage, ToolDefinition, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,wCAAwC;AACxC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EACV,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { ApiClient } from "./agentified.js";
+/** @deprecated Use ApiClient instead */
+export { ApiClient as Agentified } from "./agentified.js";
+export { tool } from "./tool.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,wCAAwC;AACxC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,3 @@
+import type { ServerTool, ToolDefinition } from "./types.js";
+export declare function tool(def: ToolDefinition): ServerTool;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAgB,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,CAYpD"}

package/dist/tool.js

@@ -0,0 +1,14 @@
+export function tool(def) {
+    return {
+        name: def.name,
+        description: def.description,
+        parameters: def.parameters,
+        ...(def.metadata && { metadata: def.metadata }),
+        fields: {
+            name: def.name,
+            description: def.description,
+            inputSchema: JSON.stringify(def.parameters),
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,IAAI,CAAC,GAAmB;IACtC,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/C,MAAM,EAAE;YACN,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;SAC5C;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+export interface ServerToolFields {
+    name: string;
+    description: string;
+    inputSchema?: string;
+    outputSchema?: string;
+}
+export interface ServerTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    fields?: ServerToolFields;
+}
+export interface RankedTool extends ServerTool {
+    score: number;
+    graphExpanded?: boolean;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface RegisterRequest {
+    tools: ServerTool[];
+}
+export interface RegisterResponse {
+    registered: number;
+}
+export interface DiscoverResponse {
+    tools: RankedTool[];
+}
+export interface Message {
+    role: string;
+    content: string;
+}
+export interface PrefetchOptions {
+    messages: Message[];
+    limit?: number;
+    exclude?: string[];
+    turnId?: string;
+}
+export interface CaptureTurnOptions {
+    toolsLoaded: string[];
+    message: string;
+}
+export interface CaptureTurnResponse {
+    turnId: string;
+}
+export interface DiscoverToolInput {
+    query: string;
+    limit?: number;
+}
+export interface DiscoverTool {
+    definition: ToolDefinition;
+    execute: (input: DiscoverToolInput) => Promise<RankedTool[]>;
+}
+export interface StoredMessage {
+    id: string;
+    role: string;
+    content: string;
+    toolCallId?: string;
+    toolCalls?: unknown;
+    createdAt: string;
+    seq: number;
+}
+export interface AppendMessagesResponse {
+    appended: number;
+    firstSeq: number;
+    lastSeq: number;
+}
+export interface GetMessagesOpts {
+    limit?: number;
+    afterSeq?: number;
+    aroundSeq?: number;
+}
+export interface GetMessagesResponse {
+    messages: StoredMessage[];
+    hasMore: boolean;
+    maxSeq: number;
+}
+export interface ContextOpts {
+    strategy?: string;
+    maxTokens?: number;
+}
+export interface ContextResponse {
+    messages: StoredMessage[];
+    strategyUsed: string;
+    totalMessages: number;
+    includedMessages: number;
+    recalled: {
+        tools: unknown[];
+        memories: unknown[];
+    };
+    tokenEstimate: number;
+    conversationMessages: number;
+    fallback: boolean;
+}
+export interface TokenUsage {
+    input: number;
+    output: number;
+    cached: number;
+    reasoning: number;
+}
+export type AgentifiedEvent = {
+    type: "agentified:prefetch:start";
+    messages: Message[];
+} | {
+    type: "agentified:prefetch:complete";
+    tools: RankedTool[];
+    durationMs: number;
+    tokenUsage?: TokenUsage;
+} | {
+    type: "agentified:prefetch:skipped";
+    tools: RankedTool[];
+    durationMs: number;
+} | {
+    type: "agentified:discover:start";
+    query: string;
+} | {
+    type: "agentified:discover:complete";
+    query: string;
+    tools: RankedTool[];
+    durationMs: number;
+    tokenUsage?: TokenUsage;
+};
+export interface ApiClientConfig {
+    serverUrl: string;
+    tools: ServerTool[];
+    onEvent?: (event: AgentifiedEvent) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Server types (mirror Rust models)
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "agentified",
+  "version": "0.0.4",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentified/agentified",
+    "directory": "src/ts-packages/sdk"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:e2e": "AGENTIFIED_TEST_URL=http://localhost:9119 vitest run src/__tests__/integration.test.ts"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.0",
+    "vitest": "^2.1.0"
+  }
+}