agentic-assistant 0.0.0-stage → 0.1.0

package/dist/testing.d.ts

@@ -0,0 +1,29 @@
+import { M as ModelProvider, P as Pricing, a as ModelRequest, S as StopReason, U as Usage, b as ModelEvent } from './types-C47SyHH5.js';
+
+interface ScriptedTurn {
+    text?: string;
+    toolCalls?: {
+        name: string;
+        input: unknown;
+        id?: string;
+    }[];
+    /** Default: "tool_use" when there are tool calls, else "end_turn". */
+    stopReason?: StopReason;
+    usage?: Usage;
+}
+/**
+ * A model that replays a fixed script, one turn per request. Use it in E2E
+ * tests so runs are deterministic. It records each request it receives.
+ */
+declare class ScriptedProvider implements ModelProvider {
+    private readonly script;
+    readonly pricing?: Pricing | undefined;
+    readonly name = "scripted";
+    readonly model = "scripted-1";
+    readonly requests: ModelRequest[];
+    private next;
+    constructor(script: readonly ScriptedTurn[], pricing?: Pricing | undefined);
+    stream(request: ModelRequest): AsyncGenerator<ModelEvent>;
+}
+
+export { ScriptedProvider, type ScriptedTurn };

package/dist/testing.js

@@ -0,0 +1,35 @@
+// src/testing.ts
+var ScriptedProvider = class {
+  constructor(script, pricing) {
+    this.script = script;
+    this.pricing = pricing;
+  }
+  script;
+  pricing;
+  name = "scripted";
+  model = "scripted-1";
+  requests = [];
+  next = 0;
+  async *stream(request) {
+    this.requests.push({ ...request, messages: structuredClone(request.messages) });
+    const turn = this.script[this.next++];
+    if (turn === void 0) throw new Error(`scripted provider ran out of turns at request ${this.next}`);
+    const content = [];
+    if (turn.text !== void 0) {
+      for (const word of turn.text.split(/(?<= )/)) yield { type: "text_delta", text: word };
+      content.push({ type: "text", text: turn.text });
+    }
+    for (const [index, call] of (turn.toolCalls ?? []).entries()) {
+      content.push({ type: "tool_use", id: call.id ?? `call_${this.next}_${index}`, name: call.name, input: call.input });
+    }
+    yield {
+      type: "message",
+      content,
+      stopReason: turn.stopReason ?? (turn.toolCalls?.length ? "tool_use" : "end_turn"),
+      usage: turn.usage ?? { inputTokens: 10, outputTokens: 5 }
+    };
+  }
+};
+export {
+  ScriptedProvider
+};

package/dist/types-C47SyHH5.d.ts

@@ -0,0 +1,72 @@
+/** A JSON Schema object that describes one tool's input. */
+type JsonSchema = Record<string, unknown>;
+type ContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: "tool_result";
+    toolUseId: string;
+    content: string;
+    isError?: boolean;
+}
+/** A block only the named provider reads (for example reasoning). Adapters send it back unchanged. */
+ | {
+    type: "provider_block";
+    provider: string;
+    raw: unknown;
+};
+interface Message {
+    role: "user" | "assistant";
+    content: ContentBlock[];
+}
+interface ToolSpec {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+}
+interface Usage {
+    inputTokens: number;
+    outputTokens: number;
+}
+type StopReason = "end_turn" | "tool_use" | "max_tokens" | "refusal" | "other";
+interface ModelRequest {
+    system?: string;
+    messages: Message[];
+    tools: ToolSpec[];
+    maxOutputTokens: number;
+    signal?: AbortSignal;
+}
+type ModelEvent = {
+    type: "text_delta";
+    text: string;
+} | {
+    type: "message";
+    content: ContentBlock[];
+    stopReason: StopReason;
+    usage: Usage;
+};
+/** Prices in US dollars per million tokens. */
+interface Pricing {
+    inputPerMTok: number;
+    outputPerMTok: number;
+}
+/**
+ * The model port. An adapter streams text deltas, then yields one final
+ * `message` event with the whole assistant turn, the stop reason, and usage.
+ */
+interface ModelProvider {
+    readonly name: string;
+    readonly model: string;
+    readonly pricing?: Pricing;
+    stream(request: ModelRequest): AsyncIterable<ModelEvent>;
+}
+declare class ProviderError extends Error {
+    constructor(message: string);
+}
+
+export { type ContentBlock as C, type JsonSchema as J, type ModelProvider as M, type Pricing as P, type StopReason as S, type ToolSpec as T, type Usage as U, type ModelRequest as a, type ModelEvent as b, type Message as c, ProviderError as d };

package/dist/worker.d.ts

@@ -0,0 +1,8 @@
+interface WorkerEnv {
+    PACK_NAME?: string;
+}
+declare const _default: {
+    fetch(request: Request, env: WorkerEnv): Promise<Response>;
+};
+
+export { type WorkerEnv, _default as default };

package/dist/worker.js

@@ -0,0 +1,17 @@
+import {
+  VERSION
+} from "./chunk-4QE7E5UQ.js";
+
+// src/worker.ts
+var worker_default = {
+  async fetch(request, env) {
+    const url = new URL(request.url);
+    if (request.method === "GET" && url.pathname === "/health") {
+      return Response.json({ ok: true, pack: env.PACK_NAME ?? "agentic-assistant", version: VERSION });
+    }
+    return Response.json({ error: "not found" }, { status: 404 });
+  }
+};
+export {
+  worker_default as default
+};

package/llms.txt

@@ -0,0 +1,14 @@
+# agentic-assistant
+
+An AI assistant that acts inside your apps with the user's own permissions.
+
+Keywords: assistant,ai,agent,tools,mcp,sdk,side-panel,approvals,eu,model-port.
+
+- SDK: import { runAssistant, ToolRegistry, createPrincipal } from "agentic-assistant".
+- Panel: import { AssistantPanel } from "agentic-assistant/react"; import "agentic-assistant/react.css".
+- Test provider: import { ScriptedProvider } from "agentic-assistant/testing".
+
+## Docs
+
+- README: https://github.com/pooriaarab/agentic-assistant
+- License: MIT

package/package.json

@@ -1,6 +1,90 @@
 {
   "name": "agentic-assistant",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "An AI assistant that acts inside your apps with the user's own permissions.",
+  "keywords": [
+    "assistant",
+    "ai",
+    "agent",
+    "tools",
+    "mcp",
+    "sdk",
+    "side-panel",
+    "approvals",
+    "eu",
+    "model-port"
+  ],
+  "license": "MIT",
+  "author": "Pooria Arab",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pooriaarab/agentic-assistant.git"
+  },
+  "type": "module",
+  "private": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "SKILL.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./react.css": "./dist/react.css"
+  },
+  "bin": {
+    "agentic-assistant": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "ci:local": "npm run build && npm run typecheck && npm test"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^1.3.0",
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "ajv": "^8.20.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.8",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "jsdom": "^30.1.3",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}