@agnt-sdk/studio 0.0.1

package/README.md

@@ -0,0 +1,162 @@
+# @agnt-sdk/studio
+
+V2 manifest-native LLM executor for [Agnt](https://agnt.ai) prompts, with a CLI for pulling and running agent manifests locally.
+
+## Installation
+
+```bash
+npm install @agnt-sdk/studio
+```
+
+For the CLI:
+
+```bash
+npm install -g @agnt-sdk/studio
+agnt --help
+```
+
+## Configuration
+
+Create `agnt.config.js` at your project root. See [`@agnt-sdk/config`](../config) for the full reference.
+
+```js
+// agnt.config.js
+export default {
+  privateKey: `-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----`,
+  kid: 'your-key-id',
+  apiUrl: 'https://api.agnt.ai',
+  serviceKey: '',
+  outputDir: './agnt/prompts',
+  apiMode: true, // false = load from local files (after agnt pull)
+};
+```
+
+## CLI
+
+### `agnt pull`
+
+Pull one or all prompt manifests from the Agnt platform into your local `outputDir`:
+
+```bash
+# Pull a specific prompt
+agnt pull myaccount/flight-planner
+
+# Pull all public prompts for an account
+agnt pull myaccount/*
+```
+
+Manifests are saved to `outputDir/accountSlug/promptSlug.json`. Set `apiMode: false` in your config to execute from these local files instead of fetching from the API on every run.
+
+### `agnt init`
+
+Scaffold an `agnt.config.js` in the current directory:
+
+```bash
+agnt init
+```
+
+## Programmatic use
+
+### `AgntExecutor`
+
+Execute a prompt by address (`accountSlug/promptSlug`). Fetches the manifest from the API or a local file depending on `apiMode`.
+
+```ts
+import { AgntExecutor } from '@agnt-sdk/studio';
+
+const executor = await AgntExecutor.create({
+  credentials: {
+    anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
+  },
+});
+
+const result = await executor.execute(
+  'myaccount/flight-planner',
+  { destination: 'New York', departDate: '2025-06-15' },
+  {
+    // optional tool implementations
+    get_flights: {
+      execute: async (args) => { /* ... */ }
+    }
+  }
+);
+
+console.log(result.result);   // final output
+console.log(result.messages); // full message history
+console.log(result.usage);    // token usage + cost
+```
+
+### `createExecutor`
+
+Lower-level factory — takes a V2 `PromptManifestV2` object directly:
+
+```ts
+import { createExecutor } from '@agnt-sdk/studio';
+
+const executor = await createExecutor({
+  manifest,
+  credentials: {
+    anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
+  },
+  variables: { key: 'value' },
+  toolRouter: { /* tool implementations */ },
+});
+
+const result = await executor.execute();
+```
+
+## Logging
+
+Pass `logLevel` to control output verbosity:
+
+```ts
+const executor = await createExecutor({
+  manifest,
+  credentials,
+  logLevel: 'debug',  // 'debug' | 'info' | 'silent'  (default: 'info')
+});
+```
+
+- `'info'` — lifecycle events (model selection, tool calls)
+- `'debug'` — full request/response payloads sent to the LLM
+- `'silent'` — no output
+
+## V2 Manifest format
+
+```json
+{
+  "$schema": "https://agnt.ai/schemas/manifest/v2.json",
+  "kind": "PromptManifest",
+  "apiVersion": "v2",
+  "metadata": {
+    "name": "flight-planner",
+    "title": "Flight Planner",
+    "description": "Books flights based on user preferences."
+  },
+  "spec": {
+    "routingStrategy": "fallback",
+    "enableToolCalls": true,
+    "variables": [],
+    "models": [
+      { "provider": "anthropic", "model": "claude-sonnet-4-5" }
+    ],
+    "tools": [],
+    "files": [],
+    "dependencies": []
+  }
+}
+```
+
+## Supported providers
+
+| Provider | Credentials key |
+|---|---|
+| Anthropic | `credentials.anthropic.apiKey` |
+| OpenAI | `credentials.openai.apiKey` |
+| AWS Bedrock | `credentials.bedrock.{ region, accessKeyId, secretAccessKey }` |
+| DeepSeek | `credentials.deepseek.apiKey` |
+| Google Gemini | `credentials.google.apiKey` |
+
+## License
+
+MIT

package/dist/AgntExecutor.d.ts

@@ -0,0 +1,56 @@
+/**
+ * AgntExecutor
+ *
+ * High-level executor that loads v2 PromptManifests by address
+ * (`accountSlug/promptSlug`) from the Agnt API or local files,
+ * then executes them via the appropriate provider adapter.
+ *
+ * Usage:
+ *   const executor = await AgntExecutor.create({ credentials });
+ *   const result = await executor.execute('skej/contact-collector', variables, toolRouter);
+ */
+import { AgntApiClient } from './cli/utils/api.js';
+import type { ProviderCredentials, ExecutionResult, ToolRouter, ToolCallCallback, TracingConfig, AgntConfig, Message } from './types.js';
+export interface AgntExecutorConfig {
+    credentials: ProviderCredentials;
+    config?: AgntConfig;
+}
+export interface AgntExecuteOptions {
+    onToolCall?: ToolCallCallback;
+    tracing?: Pick<TracingConfig, 'enabled' | 'tags'>;
+    files?: Array<{
+        type: string;
+        image_url?: {
+            url: string;
+        };
+        input_audio?: {
+            data: string;
+            format: string;
+        };
+    }>;
+    apiMode?: boolean;
+    initialToolChoice?: string;
+    messages?: Message[];
+}
+export declare class AgntExecutor {
+    private credentials;
+    private config;
+    private client;
+    private constructor();
+    static create(options: AgntExecutorConfig): Promise<AgntExecutor>;
+    /**
+     * Execute a prompt by address.
+     *
+     * @param address   `accountSlug/promptSlug`
+     * @param variables Runtime variables
+     * @param toolRouter Tool implementations
+     * @param options   Optional execution options
+     */
+    execute(address: string, variables?: Record<string, any>, toolRouter?: ToolRouter, options?: AgntExecuteOptions): Promise<ExecutionResult>;
+    private parseAddress;
+    private loadFromApi;
+    private loadFromFile;
+    getConfig(): AgntConfig;
+    getClient(): AgntApiClient;
+}
+//# sourceMappingURL=AgntExecutor.d.ts.map

package/dist/AgntExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgntExecutor.d.ts","sourceRoot":"","sources":["../src/AgntExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAEV,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,WAAW,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC7G,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAE9B,OAAO;WASM,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAYvE;;;;;;;OAOG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EACnC,UAAU,GAAE,UAAe,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,CAAC;IAsC3B,OAAO,CAAC,YAAY;YAWN,WAAW;YAIX,YAAY;IA2B1B,SAAS,IAAI,UAAU;IAIvB,SAAS,IAAI,aAAa;CAG3B"}

package/dist/AgntExecutor.js

@@ -0,0 +1,117 @@
+/**
+ * AgntExecutor
+ *
+ * High-level executor that loads v2 PromptManifests by address
+ * (`accountSlug/promptSlug`) from the Agnt API or local files,
+ * then executes them via the appropriate provider adapter.
+ *
+ * Usage:
+ *   const executor = await AgntExecutor.create({ credentials });
+ *   const result = await executor.execute('skej/contact-collector', variables, toolRouter);
+ */
+import { createExecutor } from './executorFactory.js';
+import { AgntApiClient } from './cli/utils/api.js';
+import { loadConfig } from './cli/utils/config.js';
+export class AgntExecutor {
+    credentials;
+    config;
+    client;
+    constructor(credentials, config) {
+        this.credentials = credentials;
+        this.config = config;
+        this.client = new AgntApiClient({
+            apiUrl: config.apiUrl,
+            serviceKey: config.serviceKey
+        });
+    }
+    static async create(options) {
+        let config = options.config;
+        if (!config) {
+            const loaded = await loadConfig();
+            if (!loaded) {
+                throw new Error('No agnt.config.js found. Run: agnt init');
+            }
+            config = loaded;
+        }
+        return new AgntExecutor(options.credentials, config);
+    }
+    /**
+     * Execute a prompt by address.
+     *
+     * @param address   `accountSlug/promptSlug`
+     * @param variables Runtime variables
+     * @param toolRouter Tool implementations
+     * @param options   Optional execution options
+     */
+    async execute(address, variables = {}, toolRouter = {}, options) {
+        const { accountSlug, promptSlug } = this.parseAddress(address);
+        const useApi = options?.apiMode !== undefined ? options.apiMode : this.config.apiMode;
+        const manifest = useApi
+            ? await this.loadFromApi(accountSlug, promptSlug)
+            : await this.loadFromFile(accountSlug, promptSlug);
+        const tracingConfig = options?.tracing ? {
+            enabled: options.tracing.enabled,
+            apiUrl: this.config.apiUrl,
+            serviceKey: this.config.serviceKey,
+            promptName: address,
+            etag: manifest.metadata.etag,
+            tags: options.tracing.tags
+        } : undefined;
+        const executor = await createExecutor({
+            manifest,
+            credentials: this.credentials,
+            variables,
+            toolRouter,
+            maxMessages: this.config.maxMessages,
+            onToolCall: options?.onToolCall,
+            tracing: tracingConfig,
+            files: options?.files,
+            initialToolChoice: options?.initialToolChoice,
+            messages: options?.messages
+        });
+        return executor.execute();
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Loading
+    // ─────────────────────────────────────────────────────────────────────────────
+    parseAddress(address) {
+        const parts = address.split('/');
+        if (parts.length !== 2 || !parts[0] || !parts[1]) {
+            throw new Error(`[AgntExecutor] Invalid prompt address: "${address}". ` +
+                'Expected format: "accountSlug/promptSlug"');
+        }
+        return { accountSlug: parts[0], promptSlug: parts[1] };
+    }
+    async loadFromApi(accountSlug, promptSlug) {
+        return this.client.getManifest(accountSlug, promptSlug);
+    }
+    async loadFromFile(accountSlug, promptSlug) {
+        if (typeof process === 'undefined' || !process.versions?.node) {
+            throw new Error('File mode is only supported in Node.js. Use apiMode: true for browser.');
+        }
+        const { join, resolve } = await import('path');
+        const { readFile } = await import('fs/promises');
+        const outputDir = resolve(this.config.outputDir);
+        const filePath = join(outputDir, accountSlug, `${promptSlug}.json`);
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const parsed = JSON.parse(content);
+            // File format: { manifest: PromptManifestV2, pulledAt: ISO }
+            return parsed.manifest ?? parsed;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`Prompt file not found: ${filePath}\n` +
+                    `Run 'agnt pull ${accountSlug}/${promptSlug}' to download it.`);
+            }
+            throw err;
+        }
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getClient() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=AgntExecutor.js.map

package/dist/AgntExecutor.js.map

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

package/dist/BaseExecutor.d.ts

@@ -0,0 +1,69 @@
+/**
+ * BaseExecutor — V2 PromptManifest native executor
+ *
+ * Operates directly on the v2 manifest spec:
+ * - Renders files/blocks from spec.files[] (no pre-compiled system/user strings)
+ * - Evaluates conditions on files, blocks, tools, and models at runtime
+ * - Respects enableToolCalls: false (skips tool loop, returns raw LLM text)
+ * - Routes models via routingStrategy (fallback | random | conditional)
+ */
+import type { BaseExecutorConfig, PromptManifestV2, V2ModelConfig, PromptBlock, Message, ToolCall, ToolResult, ToolDefinition, InvokeOptions, InvokeResult, ExecutionResult, Usage, ToolRouter, ToolCallCallback, TracingConfig, ModelPricing } from './types.js';
+export default class BaseExecutor {
+    protected manifest: PromptManifestV2;
+    protected variables: Record<string, any>;
+    protected toolRouter: ToolRouter;
+    protected credentials: any;
+    protected log: (message: string, ...args: any[]) => void;
+    protected debug: (message: string, ...args: any[]) => void;
+    protected messages: Message[];
+    protected onToolCall?: ToolCallCallback;
+    protected cancelled: boolean;
+    protected toolErrorCount: Record<string, number>;
+    protected forceNextTool?: string;
+    protected executorFactory?: (config: BaseExecutorConfig) => Promise<any>;
+    protected instructions: string;
+    protected primaryModelConfig: V2ModelConfig & {
+        name: string;
+    };
+    protected provider: string;
+    protected model: string;
+    protected allToolDefs: ToolDefinition[];
+    protected tracing?: TracingConfig;
+    protected files?: Array<any>;
+    protected maxMessages: number;
+    protected modelPricing?: ModelPricing;
+    protected initialToolChoice: 'auto' | 'required' | 'none' | string;
+    constructor({ manifest, variables, toolRouter, credentials, messages, onToolCall, log, logLevel, tracing, files, maxMessages, initialToolChoice, executorFactory }: BaseExecutorConfig);
+    protected validateManifest(): void;
+    protected selectPrimaryModel(): V2ModelConfig;
+    protected buildToolDefinitions(): ToolDefinition[];
+    /**
+     * Reorder tool schema properties so reasoning fields appear first.
+     * Ensures LLM generates reason before action when strict: true.
+     */
+    protected processToolDefinition(tool: ToolDefinition): ToolDefinition;
+    protected reorderReasoningFields(schema: any): any;
+    /**
+     * Render all files for a given section into a single string.
+     */
+    protected renderSection(section: 'system' | 'messages'): string;
+    protected renderBlocks(blocks: PromptBlock[]): string;
+    protected renderBlock(block: PromptBlock): string;
+    protected buildInstructions(): string;
+    protected populateTemplate(template: string, variables: Record<string, any>): string;
+    protected normalizeToolChoice(toolChoice: 'auto' | 'required' | 'none' | string): any;
+    cancel(): boolean;
+    protected validateVariables(): void;
+    protected buildInitialMessages(): Message[];
+    protected calculateCost(inputTokens: number, outputTokens: number): number;
+    execute(): Promise<ExecutionResult>;
+    protected runToolLoop(message: Message, usage: Usage): Promise<any>;
+    protected handleToolCalls(toolCalls: ToolCall[]): Promise<ToolResult[]>;
+    protected sendTurnTrace(turnUsage: {
+        input_tokens: number;
+        output_tokens: number;
+    }, turnDuration: number, cost: number): Promise<void>;
+    invoke(_messages: Message[], _options: InvokeOptions): Promise<InvokeResult>;
+    hasToolCalls(_message: Message): boolean;
+}
+//# sourceMappingURL=BaseExecutor.d.ts.map

package/dist/BaseExecutor.d.ts.map

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