@nexface/agent 0.1.1-alpha.0

package/dist/types.d.ts

@@ -0,0 +1,129 @@
+import type { ToolRuntime, AgentToolInputSchema } from "@nexface/tools";
+import type { AgentModelConfig, AgentModelInfo } from "./model/types.js";
+import type { ToolBridge } from "./tool-bridge.js";
+import type { TextInputContent, ImageInputContent, RunStartedEvent, RunFinishedEvent, RunErrorEvent, TextMessageStartEvent, TextMessageContentEvent, TextMessageEndEvent, ToolCallStartEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallResultEvent } from "@ag-ui/core";
+export type AgentInputContent = TextInputContent | ImageInputContent;
+export declare const agentBrand: unique symbol;
+export type AgentMessage = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string | AgentInputContent[];
+} | {
+    role: "application_context";
+    revision: number;
+    content: string;
+} | {
+    role: "assistant";
+    content: string | null;
+    toolCalls: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+} | {
+    role: "tool";
+    toolCallId: string;
+    name: string;
+    content: string;
+};
+export interface AgentModelToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+export interface AgentModelTool {
+    name: string;
+    description: string;
+    inputSchema: AgentToolInputSchema;
+}
+export interface AgentModelResponse {
+    content: string | null;
+    toolCalls: AgentModelToolCall[];
+    usage?: {
+        promptTokens?: number;
+        cachedPromptTokens?: number;
+        cacheMissPromptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    accept?(): void;
+}
+export interface AgentRunOptions {
+    signal?: AbortSignal;
+}
+export type ToolApprovalInterruptDescriptor = {
+    readonly type: "tool-approval";
+    readonly id: string;
+    readonly runId: string;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly input: unknown;
+    readonly title?: string;
+    readonly description?: string;
+} & ({
+    readonly mode: "chat";
+    readonly confirmLabel?: string;
+    readonly rejectLabel?: string;
+} | {
+    readonly mode: "page";
+});
+export type AgentRunResult = {
+    readonly status: "completed";
+    readonly output: string;
+} | {
+    readonly status: "interrupted";
+    readonly interrupt: ToolApprovalInterruptDescriptor;
+};
+export type AgentRunEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent;
+export interface AgentRun extends AsyncIterable<AgentRunEvent> {
+    readonly id: string;
+    readonly result: Promise<AgentRunResult>;
+    cancel(): void;
+}
+export type AgentRunInput = {
+    readonly message: {
+        readonly content: string | readonly AgentInputContent[];
+    };
+    readonly resume?: never;
+} | {
+    readonly message?: never;
+    readonly resume: readonly [
+        {
+            readonly interruptId: string;
+            readonly status: "resolved";
+            readonly payload: {
+                readonly approved: boolean;
+            };
+            readonly metadata?: Readonly<Record<string, unknown>>;
+        }
+    ];
+};
+export interface AgentSkill {
+    readonly name: string;
+    readonly description: string;
+    readonly instructions: string;
+}
+export type CreateAgentOptions = {
+    model: AgentModelConfig;
+    skills?: readonly AgentSkill[];
+    maxSteps?: number;
+    maxRetries?: number;
+    applicationContext?: {
+        maxSizeBytes?: number;
+    };
+} & ({
+    toolRuntime: ToolRuntime;
+    toolBridge?: never;
+} | {
+    toolBridge: ToolBridge;
+    toolRuntime?: never;
+});
+export interface Agent {
+    readonly [agentBrand]: true;
+    readonly id: string;
+    readonly model: AgentModelInfo;
+    switchModel(model: AgentModelConfig): Promise<void>;
+    run(input: AgentRunInput, options?: AgentRunOptions): AgentRun;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const agentBrand = Symbol("@nexface/agent");
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@nexface/agent",
+  "version": "0.1.1-alpha.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./openai-completions": {
+      "types": "./dist/models/openai-completions.d.ts",
+      "default": "./dist/models/openai-completions.js"
+    },
+    "./openai-responses": {
+      "types": "./dist/models/openai-responses.d.ts",
+      "default": "./dist/models/openai-responses.js"
+    },
+    "./anthropic-messages": {
+      "types": "./dist/models/anthropic-messages.d.ts",
+      "default": "./dist/models/anthropic-messages.js"
+    },
+    "./google-generative-ai": {
+      "types": "./dist/models/google-generative-ai.d.ts",
+      "default": "./dist/models/google-generative-ai.js"
+    }
+  },
+  "files": [
+    "dist",
+    "THIRD_PARTY_LICENSES.txt"
+  ],
+  "dependencies": {
+    "@ag-ui/core": "0.0.59"
+  },
+  "scripts": {
+    "build": "node ../../scripts/generate-browser-tools-skill.mjs --check && node scripts/clean.mjs && tsc -p tsconfig.json && rslib build && node scripts/clean-model-output.mjs",
+    "typecheck": "node ../../scripts/generate-browser-tools-skill.mjs --check && tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@nexface/tools": "0.1.1-alpha.0",
+    "@earendil-works/pi-ai": "0.84.1",
+    "@rslib/core": "0.23.2",
+    "rspack-1-7": "npm:@rspack/core@1.7.12"
+  },
+  "peerDependencies": {
+    "@nexface/tools": "0.1.1-alpha.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "tag": "alpha",
+    "access": "public"
+  }
+}