@codeworksh/aikit 0.3.1 → 0.4.0

package/README.md

@@ -1,6 +1,8 @@
 # @codeworksh/aikit
 
-Toolkit for building AI agents and streaming LLM workflows.
+@codeworksh/aikit is **TypeScript SDK** for building AI agents and agentic harness. Provides a unified API for working with multiple LLM providers and support for tool calling(function calling) required for agentic workflows.
+
+@codeworksh/aikit isn't just another SDK. It gives you the basic primitives for streaming LLM responses without the extra bloat, letting you handle the agentic orchestration yourself.
 
 ## Installation
 
@@ -10,7 +12,7 @@ npm install @codeworksh/aikit
 
 Node `>=24.14.1` is required.
 
-## What You Get
+## API Overview
 
 - `llm(...)` to resolve a model from the built-in registry
 - `stream(...)` and `stream.complete(...)` for provider-normalized LLM streaming
@@ -18,21 +20,15 @@ Node `>=24.14.1` is required.
 - `agent.loop(...)` and `agent.loopContinue(...)` for lower-level turn orchestration
 - `Message` helpers for typed messages and generated `messageId` values
 
-## Root API
-
-```ts
-import { Agent, Message, agent, llm, stream } from "@codeworksh/aikit";
-```
-
 ## Quick Start
 
 ```ts
 import { Agent } from "@codeworksh/aikit";
 
 const agent = await Agent.create({
-	provider: "anthropic",
-	model: "claude-haiku-4-5-20251001",
-	getApiKey: async () => process.env.ANTHROPIC_API_KEY,
+  provider: "anthropic",
+  model: "claude-haiku-4-5-20251001",
+  getApiKey: async () => process.env.ANTHROPIC_API_KEY,
 });
 
 agent.setSystemPrompt("Be concise.");
@@ -55,23 +51,23 @@ const model = await llm("anthropic", "claude-haiku-4-5-20251001");
 if (!model) throw new Error("Model not found");
 
 const s = stream(
-	model,
-	{
-		messages: [
-			Message.createUserMessage({
-				role: "user",
-				time: { created: Date.now() },
-				parts: [{ type: "text", text: "Count from 1 to 3" }],
-			}),
-		],
-	},
-	{ apiKey: process.env.ANTHROPIC_API_KEY },
+  model,
+  {
+    messages: [
+      Message.createUserMessage({
+        role: "user",
+        time: { created: Date.now() },
+        parts: [{ type: "text", text: "Count from 1 to 3" }],
+      }),
+    ],
+  },
+  { apiKey: process.env.ANTHROPIC_API_KEY },
 );
 
 for await (const event of s) {
-	if (event.type === "text.delta") {
-		process.stdout.write(event.delta);
-	}
+  if (event.type === "text.delta") {
+    process.stdout.write(event.delta);
+  }
 }
 
 const finalMessage = await s.result();
@@ -86,17 +82,17 @@ console.log(finalMessage.messageId);
 import { Agent } from "@codeworksh/aikit";
 
 const agent = await Agent.create({
-	provider: "anthropic",
-	model: "claude-haiku-4-5-20251001",
-	getApiKey: async () => process.env.ANTHROPIC_API_KEY,
+  provider: "anthropic",
+  model: "claude-haiku-4-5-20251001",
+  getApiKey: async () => process.env.ANTHROPIC_API_KEY,
 });
 
 agent.setSystemPrompt("Be concise.");
 
 agent.subscribe((event) => {
-	if (event.type === "message.end") {
-		console.log(event.message.role, event.message.messageId);
-	}
+  if (event.type === "message.end") {
+    console.log(event.message.role, event.message.messageId);
+  }
 });
 
 await agent.prompt([{ type: "text", text: "Say hello in one line." }]);
@@ -111,33 +107,35 @@ import { Type } from "@sinclair/typebox";
 import { Agent } from "@codeworksh/aikit";
 
 const calculatorTool = Agent.defineTool({
-	name: "calculator",
-	label: "Calculator",
-	description: "Evaluate arithmetic expressions",
-	parameters: Type.Object({
-		expression: Type.String(),
-	}),
-	async execute(_callID, params) {
-		return {
-			status: "completed",
-			result: {
-				content: [{ type: "text", text: `result for ${params.expression}` }],
-				isError: false,
-			},
-		};
-	},
+  name: "calculator",
+  label: "Calculator",
+  description: "Evaluate arithmetic expressions",
+  parameters: Type.Object({
+    expression: Type.String(),
+  }),
+  async execute(_callID, params) {
+    return {
+      status: "completed",
+      result: {
+        content: [{ type: "text", text: `result for ${params.expression}` }],
+        isError: false,
+      },
+    };
+  },
 });
 
 const instance = await Agent.create({
-	provider: "anthropic",
-	model: "claude-haiku-4-5-20251001",
-	getApiKey: async () => process.env.ANTHROPIC_API_KEY,
-	initialState: {
-		tools: [calculatorTool],
-	},
+  provider: "anthropic",
+  model: "claude-haiku-4-5-20251001",
+  getApiKey: async () => process.env.ANTHROPIC_API_KEY,
+  initialState: {
+    tools: [calculatorTool],
+  },
 });
 
-await instance.prompt([{ type: "text", text: "Use the calculator tool for 25 * 18." }]);
+await instance.prompt([
+  { type: "text", text: "Use the calculator tool for 25 * 18." },
+]);
 ```
 
 ## Lower-Level Loop
@@ -151,23 +149,23 @@ const model = await llm("anthropic", "claude-haiku-4-5-20251001");
 if (!model) throw new Error("Model not found");
 
 const run = agent.loop(
-	{
-		model,
-		apiKey: process.env.ANTHROPIC_API_KEY,
-		convertToLlm: async (messages) => messages,
-	},
-	{
-		systemPrompt: "Be concise.",
-		messages: [],
-		tools: [],
-	},
-	[
-		Message.createUserMessage({
-			role: "user",
-			time: { created: Date.now() },
-			parts: [{ type: "text", text: "Reply with exactly: ok" }],
-		}),
-	],
+  {
+    model,
+    apiKey: process.env.ANTHROPIC_API_KEY,
+    convertToLlm: async (messages) => messages,
+  },
+  {
+    systemPrompt: "Be concise.",
+    messages: [],
+    tools: [],
+  },
+  [
+    Message.createUserMessage({
+      role: "user",
+      time: { created: Date.now() },
+      parts: [{ type: "text", text: "Reply with exactly: ok" }],
+    }),
+  ],
 );
 
 const messages = await run.result();
@@ -184,9 +182,9 @@ Use the helpers when constructing messages yourself:
 import { Message } from "@codeworksh/aikit";
 
 const userMessage = Message.createUserMessage({
-	role: "user",
-	time: { created: Date.now() },
-	parts: [{ type: "text", text: "hello" }],
+  role: "user",
+  time: { created: Date.now() },
+  parts: [{ type: "text", text: "hello" }],
 });
 
 console.log(userMessage.messageId);
@@ -194,12 +192,6 @@ console.log(userMessage.messageId);
 
 This is useful for persistence layers like SQLite, event reconciliation, and updating stored messages by identity instead of array position.
 
-## Lower-Level APIs
-
-- `stream(...)`: raw provider-normalized stream
-- `stream.complete(...)`: final assistant message without manual iteration
-- `Agent.create(...)`: stateful agent instance
-- `agent.loop(...)`: lower-level agent loop
-- `agent.loopContinue(...)`: continue from an existing context
+## Contribute
 
-API docs can be added later. For now, the tests under `packages/aikit/test/` are the best reference for concrete usage.
+@codeworksh/aikit is open to community contribution. Please ensure you submit an issue before submitting a pull request. The @codeworksh/aikit project prefers open community discussion before accepting new features.

package/{agent → dist/pack/agent}/codemode/drivers/drivers.d.mts

@@ -1,4 +1,4 @@
-import { t as CodeMode } from "../../../codemode-SiETGR3z.mjs";
+import { t as CodeMode } from "../../../codemode-BEDXG7WN.mjs";
 
 //#region src/agent/codemode/drivers/quickjs-wasi-driver.d.ts
 declare function createQuickJSWasiDriver(): CodeMode.Driver;