actoviq-agent-sdk 0.1.0

package/README.md

@@ -0,0 +1,415 @@
+# Actoviq Agent SDK
+
+[English](./README.md) | [中文](./README-zh.md)
+
+Actoviq Agent SDK is an independent, experimental agent SDK for practical multi-tool, multi-session, and bridge-assisted agent workflows.
+
+This repository is currently a testing preview under active development. APIs, runtime behavior, naming, packaging, and parity coverage may still change as the project evolves. Issues and PRs are very welcome.
+
+This project is independently developed as a public preview and is still under active iteration.
+
+Licensed under the [MIT License](./LICENSE).
+
+## Highlights
+
+- Node.js / TypeScript agent SDK with `run()`, `stream()`, sessions, tools, and MCP support
+- Actoviq Runtime bridge with built-in tools, skills, subagents, and native session/context behavior
+- Clean public SDK surface on top of a vendored non-TUI runtime
+- Interactive streaming demo for local development and agent debugging
+- Ongoing parity work for workspace management, deeper subagent APIs, and private dependency replacement
+
+## Get Started
+
+### 1. Install dependencies
+
+```bash
+npm install
+```
+
+### 2. Prepare `~/.actoviq/settings.json`
+
+Local examples expect this file:
+
+```text
+~/.actoviq/settings.json
+```
+
+Create the directory and place your JSON settings file there if it does not exist yet:
+
+```powershell
+New-Item -ItemType Directory -Force $HOME\.actoviq | Out-Null
+```
+
+### 3. Run the basic example
+
+```bash
+npm run example:quickstart
+```
+
+### 4. Start the interactive agent demo
+
+```bash
+npm run example:actoviq-interactive-agent
+```
+
+This launches a streaming REPL with tool access and an infinite session loop until you exit.
+
+## At a Glance
+
+This repository gives you two main paths:
+
+1. A clean SDK layer for app integration
+2. A runtime bridge layer for Actoviq-native non-TUI agent behavior
+
+What you can use today:
+
+- local tools with Zod schemas
+- MCP servers over local, stdio, or streamable HTTP
+- persistent sessions
+- bridge runtime introspection
+- vendored runtime file tools: `Read`, `Write`, `Edit`, `Glob`, `Grep`
+- built-in bridge runtime tools, skills, and subagents
+
+## Install As a Library
+
+```bash
+npm install actoviq-agent-sdk zod
+```
+
+## Basic SDK Example
+
+```ts
+import { z } from 'zod';
+import { createAgentSdk, loadDefaultActoviqSettings, tool } from 'actoviq-agent-sdk';
+
+await loadDefaultActoviqSettings();
+const sdk = await createAgentSdk();
+
+const addNumbers = tool(
+  {
+    name: 'add_numbers',
+    description: 'Add two numbers together.',
+    inputSchema: z.object({
+      a: z.number(),
+      b: z.number(),
+    }),
+  },
+  async ({ a, b }) => ({ sum: a + b }),
+);
+
+const result = await sdk.run('Please use the add_numbers tool to calculate 19 + 23.', {
+  tools: [addNumbers],
+  systemPrompt: 'Use the provided tools whenever they are relevant.',
+});
+
+console.log(result.text);
+await sdk.close();
+```
+
+## Core Examples
+
+### Session Example
+
+```ts
+import { createAgentSdk, loadDefaultActoviqSettings } from 'actoviq-agent-sdk';
+
+await loadDefaultActoviqSettings();
+const sdk = await createAgentSdk();
+const session = await sdk.createSession({ title: 'Demo Session' });
+
+await session.send('Remember that my project codename is Sparrow.');
+const reply = await session.send('What is my project codename?');
+
+console.log(reply.text);
+```
+
+### Stream Loop Example
+
+```ts
+import { createAgentSdk, loadDefaultActoviqSettings } from 'actoviq-agent-sdk';
+
+await loadDefaultActoviqSettings();
+const sdk = await createAgentSdk();
+
+const prompts = [
+  'Introduce yourself in one concise sentence.',
+  'Now summarize the key idea of your previous sentence in one sentence.',
+  'Finally, give two short suggestions that would help a developer call this SDK more reliably.',
+];
+
+const session = await sdk.createSession({ title: 'Stream Loop Example' });
+
+for (const prompt of prompts) {
+  const stream = session.stream(prompt);
+
+  for await (const event of stream) {
+    if (event.type === 'response.text.delta') {
+      process.stdout.write(event.delta);
+    }
+  }
+
+  const result = await stream.result;
+  console.log('\nfinal:', result.text);
+}
+
+await sdk.close();
+```
+
+## Interactive Agent Demo
+
+The repository includes a bridge-based interactive example with:
+
+- streaming answers
+- built-in tool access
+- skills and subagents through the vendored runtime
+- a configurable workspace path in code
+- an explicit JSON config path in code
+- an infinite REPL loop until the user exits
+
+Run it with:
+
+```bash
+npm run example:actoviq-interactive-agent
+```
+
+The main knobs are defined at the top of
+[`examples/actoviq-interactive-agent.ts`](./examples/actoviq-interactive-agent.ts):
+
+```ts
+const WORKSPACE_PATH = process.cwd();
+const JSON_CONFIG_PATH = path.resolve(
+  process.cwd(),
+  'examples',
+  'interactive-agent.settings.local.json',
+);
+```
+
+The repository includes:
+
+- [`examples/interactive-agent.settings.example.json`](./examples/interactive-agent.settings.example.json): safe template
+- `examples/interactive-agent.settings.local.json`: local debug file for your machine only
+
+The local debug file is ignored by git.
+
+## Runtime Bridge
+
+You can also run the vendored non-TUI Actoviq Runtime directly from this SDK.
+This bridge reuses the upstream headless CLI, so it brings along the built-in
+tool pool, skills, subagents, and native session/context behavior.
+
+```ts
+import { createActoviqBridgeSdk, loadDefaultActoviqSettings } from 'actoviq-agent-sdk';
+
+await loadDefaultActoviqSettings();
+
+const sdk = await createActoviqBridgeSdk({
+  workDir: process.cwd(),
+  maxTurns: 4,
+});
+
+const result = await sdk.run(
+  'Use Actoviq Runtime tools to inspect the examples directory, then summarize examples/quickstart.ts.',
+);
+
+console.log(result.initEvent?.agents);
+console.log(result.initEvent?.skills);
+console.log(result.sessionId);
+console.log(result.text);
+console.log(result.events.length);
+```
+
+Bridge notes:
+
+- It uses Bun to execute the vendored Actoviq Runtime CLI bundle.
+- It automatically injects env values loaded by `loadJsonConfigFile(...)` or `loadDefaultActoviqSettings()`.
+- When a system `rg` is available, the bridge prefers it automatically so `Glob` and `Grep` work even if the upstream checkout does not contain the bundled ripgrep binary.
+
+## Runtime Introspection
+
+Use the runtime introspection example when you want to inspect the currently loaded bridge runtime instead of chatting with it.
+
+Run it with:
+
+```bash
+npm run example:actoviq-introspection
+```
+
+It prints:
+
+- runtime model
+- built-in tools
+- loaded skills
+- slash commands
+- available agents
+- current context usage
+
+## File Tools
+
+You can attach the first-stage Actoviq Runtime parity file tools directly to the SDK:
+
+```ts
+import {
+  createAgentSdk,
+  createActoviqFileTools,
+  loadDefaultActoviqSettings,
+} from 'actoviq-agent-sdk';
+
+await loadDefaultActoviqSettings();
+
+const sdk = await createAgentSdk({
+  tools: createActoviqFileTools({
+    cwd: process.cwd(),
+  }),
+});
+
+const result = await sdk.run(
+  'Use Glob to inspect the examples directory, then use Read on examples/quickstart.ts.',
+);
+
+console.log(result.text);
+console.log(result.toolCalls);
+```
+
+Current parity file tools:
+
+- `Read`
+- `Write`
+- `Edit`
+- `Glob`
+- `Grep`
+
+## Native Runtime Sessions
+
+You can inspect Actoviq Runtime's native `.actoviq/projects` session store using the vendored portable session discovery logic.
+
+```ts
+import { listActoviqBridgeSessions } from 'actoviq-agent-sdk';
+
+const sessions = await listActoviqBridgeSessions({ limit: 10 });
+console.log(sessions);
+```
+
+To inspect the latest reconstructed conversation chain for a session:
+
+```ts
+import {
+  getActoviqBridgeSessionInfo,
+  getActoviqBridgeSessionMessages,
+} from 'actoviq-agent-sdk';
+
+const sessionId = 'your-session-id';
+
+const info = await getActoviqBridgeSessionInfo(sessionId);
+const messages = await getActoviqBridgeSessionMessages(sessionId);
+
+console.log(info);
+console.log(messages);
+```
+
+## Configuration
+
+The SDK resolves credentials in this order:
+
+1. Explicit options passed to `createAgentSdk()`
+2. Process environment variables
+3. A JSON file preloaded with `loadJsonConfigFile(...)`
+
+Example:
+
+```ts
+import { loadJsonConfigFile } from 'actoviq-agent-sdk';
+
+await loadJsonConfigFile('E:/configs/my-llm-config.json');
+```
+
+The JSON file can use either of these shapes:
+
+```json
+{
+  "env": {
+    "ACTOVIQ_AUTH_TOKEN": "token",
+    "ACTOVIQ_BASE_URL": "https://api.example.com/actoviq",
+    "ACTOVIQ_DEFAULT_SONNET_MODEL": "my-model"
+  }
+}
+```
+
+or:
+
+```json
+{
+  "ACTOVIQ_AUTH_TOKEN": "token",
+  "ACTOVIQ_BASE_URL": "https://api.example.com/actoviq",
+  "ACTOVIQ_DEFAULT_SONNET_MODEL": "my-model"
+}
+```
+
+Supported values include:
+
+- `ACTOVIQ_API_KEY`
+- `ACTOVIQ_AUTH_TOKEN`
+- `ACTOVIQ_BASE_URL`
+- `ACTOVIQ_MODEL`
+- `ACTOVIQ_DEFAULT_SONNET_MODEL`
+- `ACTOVIQ_DEFAULT_OPUS_MODEL`
+- `ACTOVIQ_DEFAULT_HAIKU_MODEL`
+
+For local examples and smoke tests, you can also use:
+
+```ts
+import { loadDefaultActoviqSettings } from 'actoviq-agent-sdk';
+
+await loadDefaultActoviqSettings();
+```
+
+This helper reads:
+
+1. `~/.actoviq/settings.json`
+
+## MCP Helpers
+
+```ts
+import { createAgentSdk, loadDefaultActoviqSettings, stdioMcpServer } from 'actoviq-agent-sdk';
+
+await loadDefaultActoviqSettings();
+
+const sdk = await createAgentSdk({
+  mcpServers: [
+    stdioMcpServer({
+      name: 'filesystem',
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-filesystem', '.'],
+    }),
+  ],
+});
+```
+
+## Status and Roadmap
+
+This project is still moving quickly. For the current GitHub-facing parity and follow-up worklist, see:
+
+- [ACTOVIQ_AGENT_WORKLIST.md](./ACTOVIQ_AGENT_WORKLIST.md)
+
+## Local Development
+
+```bash
+npm run typecheck
+npm test
+npm run build
+npm run smoke
+npm run example:quickstart
+npm run example:session
+npm run example:stream-loop
+npm run example:actoviq-bridge-sdk
+npm run example:actoviq-interactive-agent
+npm run example:actoviq-introspection
+npm run example:actoviq-file-tools
+npm run example:actoviq-sessions
+npm run example:actoviq-session-messages
+```
+
+`npm run smoke` loads `~/.actoviq/settings.json` and validates a live request.
+
+## Contributing
+
+This is still a fast-moving preview project. If you hit problems, see missing parity, or want to propose a cleaner API, please open an issue or submit a PR.

package/dist/src/config/loadActoviqSettings.d.ts

@@ -0,0 +1,8 @@
+import type { ActoviqSettingsData } from '../types.js';
+import { clearLoadedJsonConfig, getLoadedJsonConfig } from './loadJsonConfigFile.js';
+export interface LoadActoviqSettingsOptions {
+    settingsFile?: string;
+}
+export declare function loadActoviqSettings(options: string | LoadActoviqSettingsOptions): Promise<ActoviqSettingsData>;
+export { clearLoadedJsonConfig, getLoadedJsonConfig };
+//# sourceMappingURL=loadActoviqSettings.d.ts.map

package/dist/src/config/loadActoviqSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadActoviqSettings.d.ts","sourceRoot":"","sources":["../../../src/config/loadActoviqSettings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EAEpB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,0BAA0B;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,GAAG,0BAA0B,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CAW9B;AAED,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/src/config/loadActoviqSettings.js

@@ -0,0 +1,11 @@
+import { ConfigurationError } from '../errors.js';
+import { clearLoadedJsonConfig, getLoadedJsonConfig, loadJsonConfigFile, } from './loadJsonConfigFile.js';
+export async function loadActoviqSettings(options) {
+    const settingsFile = typeof options === 'string' ? options : options.settingsFile;
+    if (!settingsFile) {
+        throw new ConfigurationError('loadActoviqSettings now requires an explicit settingsFile path.');
+    }
+    return loadJsonConfigFile(settingsFile);
+}
+export { clearLoadedJsonConfig, getLoadedJsonConfig };
+//# sourceMappingURL=loadActoviqSettings.js.map

package/dist/src/config/loadActoviqSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadActoviqSettings.js","sourceRoot":"","sources":["../../../src/config/loadActoviqSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAMjC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA4C;IAE5C,MAAM,YAAY,GAChB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAE/D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,kBAAkB,CAC1B,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAC1C,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/src/config/loadDefaultActoviqSettings.d.ts

@@ -0,0 +1,7 @@
+import type { LoadedJsonConfigData } from '../types.js';
+export interface LoadDefaultActoviqSettingsOptions {
+    homeDir?: string;
+    candidates?: string[];
+}
+export declare function loadDefaultActoviqSettings(options?: LoadDefaultActoviqSettingsOptions): Promise<LoadedJsonConfigData>;
+//# sourceMappingURL=loadDefaultActoviqSettings.d.ts.map

package/dist/src/config/loadDefaultActoviqSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadDefaultActoviqSettings.d.ts","sourceRoot":"","sources":["../../../src/config/loadDefaultActoviqSettings.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAWD,wBAAsB,0BAA0B,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,oBAAoB,CAAC,CAe/B"}

package/dist/src/config/loadDefaultActoviqSettings.js

@@ -0,0 +1,27 @@
+import { constants as fsConstants } from 'node:fs';
+import { access } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { ConfigurationError } from '../errors.js';
+import { loadJsonConfigFile } from './loadJsonConfigFile.js';
+async function pathExists(filePath) {
+    try {
+        await access(filePath, fsConstants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function loadDefaultActoviqSettings(options = {}) {
+    const homeDir = options.homeDir ?? os.homedir();
+    const candidates = options.candidates ??
+        [path.join(homeDir, '.actoviq', 'settings.json')];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate)) {
+            return loadJsonConfigFile(candidate);
+        }
+    }
+    throw new ConfigurationError(`No default settings file was found. Checked: ${candidates.map((candidate) => `"${candidate}"`).join(', ')}`);
+}
+//# sourceMappingURL=loadDefaultActoviqSettings.js.map

package/dist/src/config/loadDefaultActoviqSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadDefaultActoviqSettings.js","sourceRoot":"","sources":["../../../src/config/loadDefaultActoviqSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAO7D,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAA6C,EAAE;IAE/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,UAAU,GACd,OAAO,CAAC,UAAU;QAClB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;IAEpD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,kBAAkB,CAC1B,gDAAgD,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7G,CAAC;AACJ,CAAC"}

package/dist/src/config/loadJsonConfigFile.d.ts

@@ -0,0 +1,8 @@
+import type { LoadedJsonConfigData } from '../types.js';
+export interface LoadJsonConfigFileOptions {
+    filePath: string;
+}
+export declare function loadJsonConfigFile(filePathOrOptions: string | LoadJsonConfigFileOptions): Promise<LoadedJsonConfigData>;
+export declare function getLoadedJsonConfig(): LoadedJsonConfigData | null;
+export declare function clearLoadedJsonConfig(): void;
+//# sourceMappingURL=loadJsonConfigFile.d.ts.map

package/dist/src/config/loadJsonConfigFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadJsonConfigFile.d.ts","sourceRoot":"","sources":["../../../src/config/loadJsonConfigFile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,kBAAkB,CACtC,iBAAiB,EAAE,MAAM,GAAG,yBAAyB,GACpD,OAAO,CAAC,oBAAoB,CAAC,CAkC/B;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,IAAI,CAEjE;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/src/config/loadJsonConfigFile.js

@@ -0,0 +1,48 @@
+import { readFile } from 'node:fs/promises';
+import { ConfigurationError } from '../errors.js';
+import { isRecord } from '../runtime/helpers.js';
+let loadedJsonConfig = null;
+export async function loadJsonConfigFile(filePathOrOptions) {
+    const filePath = typeof filePathOrOptions === 'string'
+        ? filePathOrOptions
+        : filePathOrOptions.filePath;
+    if (!filePath) {
+        throw new ConfigurationError('A JSON config file path is required.');
+    }
+    try {
+        const rawText = await readFile(filePath, 'utf8');
+        const parsed = rawText.trim().length > 0 ? JSON.parse(rawText) : {};
+        if (!isRecord(parsed)) {
+            throw new ConfigurationError(`JSON config at "${filePath}" must contain a JSON object.`);
+        }
+        loadedJsonConfig = {
+            path: filePath,
+            exists: true,
+            env: extractEnv(parsed),
+            permissions: isRecord(parsed.permissions) ? parsed.permissions : undefined,
+            raw: parsed,
+        };
+        return structuredClone(loadedJsonConfig);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new ConfigurationError(`Failed to parse JSON config at "${filePath}".`, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+export function getLoadedJsonConfig() {
+    return loadedJsonConfig ? structuredClone(loadedJsonConfig) : null;
+}
+export function clearLoadedJsonConfig() {
+    loadedJsonConfig = null;
+}
+function extractEnv(parsed) {
+    if (isRecord(parsed.env)) {
+        return Object.fromEntries(Object.entries(parsed.env).filter((entry) => typeof entry[1] === 'string'));
+    }
+    return Object.fromEntries(Object.entries(parsed).filter((entry) => /^[A-Z0-9_]+$/.test(entry[0]) && typeof entry[1] === 'string'));
+}
+//# sourceMappingURL=loadJsonConfigFile.js.map

package/dist/src/config/loadJsonConfigFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadJsonConfigFile.js","sourceRoot":"","sources":["../../../src/config/loadJsonConfigFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMjD,IAAI,gBAAgB,GAAgC,IAAI,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,iBAAqD;IAErD,MAAM,QAAQ,GACZ,OAAO,iBAAiB,KAAK,QAAQ;QACnC,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC;IAEjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,QAAQ,+BAA+B,CAAC,CAAC;QAC3F,CAAC;QAED,gBAAgB,GAAG;YACjB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC;YACvB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;YAC1E,GAAG,EAAE,MAAM;SACZ,CAAC;QAEF,OAAO,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,QAAQ,IAAI,EAAE;gBAC5E,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,MAA+B;IACjD,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAC/B,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CACnE,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAC3B,CAAC,KAAK,EAA6B,EAAE,CACnC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAChE,CACF,CAAC;AACJ,CAAC"}

package/dist/src/config/resolveRuntimeConfig.d.ts

@@ -0,0 +1,3 @@
+import type { CreateAgentSdkOptions, ResolvedRuntimeConfig } from '../types.js';
+export declare function resolveRuntimeConfig(options?: CreateAgentSdkOptions): Promise<ResolvedRuntimeConfig>;
+//# sourceMappingURL=resolveRuntimeConfig.d.ts.map

package/dist/src/config/resolveRuntimeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRuntimeConfig.d.ts","sourceRoot":"","sources":["../../../src/config/resolveRuntimeConfig.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAuBhF,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAqEhC"}

package/dist/src/config/resolveRuntimeConfig.js

@@ -0,0 +1,64 @@
+import os from 'node:os';
+import path from 'node:path';
+import { ConfigurationError } from '../errors.js';
+import { getLoadedJsonConfig } from './loadJsonConfigFile.js';
+const LEGACY_ENV_KEYS = {
+    apiKey: ['ANTH', 'ROPIC_API_KEY'].join(''),
+    authToken: ['ANTH', 'ROPIC_AUTH_TOKEN'].join(''),
+    model: ['ANTH', 'ROPIC_MODEL'].join(''),
+    baseUrl: ['ANTH', 'ROPIC_BASE_URL'].join(''),
+    defaultSonnetModel: ['ANTH', 'ROPIC_DEFAULT_SONNET_MODEL'].join(''),
+    defaultOpusModel: ['ANTH', 'ROPIC_DEFAULT_OPUS_MODEL'].join(''),
+    defaultHaikuModel: ['ANTH', 'ROPIC_DEFAULT_HAIKU_MODEL'].join(''),
+};
+const FALLBACK_MODEL = ['cl', 'aude-sonnet-4-5-20250929'].join('');
+function getConfigValue(source, primaryKey, legacyKey) {
+    return source[primaryKey] ?? (legacyKey ? source[legacyKey] : undefined);
+}
+export async function resolveRuntimeConfig(options = {}) {
+    const homeDir = options.homeDir ?? os.homedir();
+    const loadedConfig = getLoadedJsonConfig();
+    const envFromLoadedConfig = loadedConfig?.env ?? {};
+    const envFromProcess = process.env;
+    const apiKey = options.apiKey ??
+        getConfigValue(envFromProcess, 'ACTOVIQ_API_KEY', LEGACY_ENV_KEYS.apiKey) ??
+        getConfigValue(envFromLoadedConfig, 'ACTOVIQ_API_KEY', LEGACY_ENV_KEYS.apiKey);
+    const authToken = options.authToken ??
+        getConfigValue(envFromProcess, 'ACTOVIQ_AUTH_TOKEN', LEGACY_ENV_KEYS.authToken) ??
+        getConfigValue(envFromLoadedConfig, 'ACTOVIQ_AUTH_TOKEN', LEGACY_ENV_KEYS.authToken);
+    if (!options.modelApi && !apiKey && !authToken) {
+        throw new ConfigurationError(loadedConfig
+            ? `No Actoviq credential was found. Checked process.env and "${loadedConfig.path}".`
+            : 'No Actoviq credential was found. Checked process.env and the preloaded JSON config. Call loadJsonConfigFile(...) before createAgentSdk() if you want to use a JSON file.');
+    }
+    const model = options.model ??
+        getConfigValue(envFromProcess, 'ACTOVIQ_MODEL', LEGACY_ENV_KEYS.model) ??
+        getConfigValue(envFromLoadedConfig, 'ACTOVIQ_MODEL', LEGACY_ENV_KEYS.model) ??
+        getConfigValue(envFromLoadedConfig, 'ACTOVIQ_DEFAULT_SONNET_MODEL', LEGACY_ENV_KEYS.defaultSonnetModel) ??
+        getConfigValue(envFromLoadedConfig, 'ACTOVIQ_DEFAULT_OPUS_MODEL', LEGACY_ENV_KEYS.defaultOpusModel) ??
+        getConfigValue(envFromLoadedConfig, 'ACTOVIQ_DEFAULT_HAIKU_MODEL', LEGACY_ENV_KEYS.defaultHaikuModel) ??
+        FALLBACK_MODEL;
+    return {
+        homeDir,
+        loadedConfigPath: loadedConfig?.path,
+        apiKey,
+        authToken,
+        baseURL: options.baseURL ??
+            getConfigValue(envFromProcess, 'ACTOVIQ_BASE_URL', LEGACY_ENV_KEYS.baseUrl) ??
+            getConfigValue(envFromLoadedConfig, 'ACTOVIQ_BASE_URL', LEGACY_ENV_KEYS.baseUrl),
+        model,
+        maxTokens: options.maxTokens ?? 2048,
+        temperature: options.temperature,
+        timeoutMs: options.timeoutMs ?? 120000,
+        maxRetries: options.maxRetries ?? 2,
+        workDir: options.workDir ?? process.cwd(),
+        sessionDirectory: options.sessionDirectory ?? path.join(homeDir, '.actoviq', 'actoviq-agent-sdk'),
+        clientName: options.clientName ?? 'actoviq-agent-sdk',
+        clientVersion: options.clientVersion ?? '0.1.0',
+        systemPrompt: options.systemPrompt,
+        maxToolIterations: options.maxToolIterations ?? 12,
+        userId: options.userId,
+        metadata: { ...(options.metadata ?? {}) },
+    };
+}
+//# sourceMappingURL=resolveRuntimeConfig.js.map

package/dist/src/config/resolveRuntimeConfig.js.map

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

package/dist/src/errors.d.ts

@@ -0,0 +1,35 @@
+export declare class ActoviqSdkError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class ConfigurationError extends ActoviqSdkError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class SessionNotFoundError extends ActoviqSdkError {
+    constructor(sessionId: string);
+}
+export declare class ToolExecutionError extends ActoviqSdkError {
+    readonly toolName: string;
+    constructor(toolName: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class RunAbortedError extends ActoviqSdkError {
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class ActoviqBridgeProcessError extends ActoviqSdkError {
+    readonly stderr?: string;
+    readonly exitCode?: number | null;
+    constructor(message: string, options?: {
+        cause?: unknown;
+        stderr?: string;
+        exitCode?: number | null;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAsB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKvF;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D;AAED,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,SAAS,EAAE,MAAM;CAG9B;AAED,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI7E;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,SAAyB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5E;AAED,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAM3E"}