@charming_groot/core 0.1.0

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":""}

package/dist/types/events.d.ts

@@ -0,0 +1,77 @@
+import type { Message, LlmResponse, ToolCall } from './provider.js';
+import type { ToolResult } from './tool.js';
+import type { ExecutionResult } from './sandbox.js';
+export interface AgentEvents {
+    'agent:start': {
+        runId: string;
+        model: string;
+        startedAt: number;
+    };
+    'agent:end': {
+        runId: string;
+        reason: string;
+        durationMs: number;
+        iterations: number;
+    };
+    'agent:error': {
+        runId: string;
+        error: Error;
+    };
+    'llm:request': {
+        runId: string;
+        messages: readonly Message[];
+    };
+    'llm:response': {
+        runId: string;
+        response: LlmResponse;
+        durationMs: number;
+        model: string;
+    };
+    'llm:stream': {
+        runId: string;
+        chunk: string;
+    };
+    'tool:start': {
+        runId: string;
+        toolCall: ToolCall;
+        startedAt: number;
+    };
+    'tool:end': {
+        runId: string;
+        toolCall: ToolCall;
+        result: ToolResult;
+        durationMs: number;
+    };
+    'tool:permission': {
+        runId: string;
+        toolName: string;
+    };
+    'sandbox:execute': {
+        runId: string;
+        language: string;
+    };
+    'sandbox:result': {
+        runId: string;
+        result: ExecutionResult;
+    };
+    'mcp:connected': {
+        server: string;
+        toolCount: number;
+    };
+    'mcp:disconnected': {
+        server: string;
+    };
+    'mcp:tools_changed': {
+        server: string;
+        tools: readonly string[];
+    };
+    'context:assembled': {
+        runId: string;
+        usage: unknown;
+        wasCompressed: boolean;
+        toolCount: number;
+    };
+}
+export type EventName = keyof AgentEvents;
+export type EventPayload<K extends EventName> = AgentEvents[K];
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAC/C,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,CAAC;IAC/D,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1F,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,gBAAgB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC;IAC7D,eAAe,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,mBAAmB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAClE,mBAAmB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACnG;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC;AAC1C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+export type { JsonValue, JsonObject, Identifiable, Timestamped, Disposable, } from './common.js';
+export type { ToolParameter, ToolDescription, ToolResult, ITool, } from './tool.js';
+export { toolResultSchema } from './tool.js';
+export type { MessageRole, ToolCall, ToolResultMessage, Message, StopReason, LlmResponse, TokenUsage, StreamEvent, ILlmProvider, } from './provider.js';
+export type { SandboxConfig, ExecutionRequest, ExecutionResult, ISandbox, } from './sandbox.js';
+export type { AgentEvents, EventName, EventPayload, } from './events.js';
+export type { AuthType, NoAuth, ApiKeyAuth, OAuthAuth, AzureAdAuth, AwsIamAuth, GcpServiceAccountAuth, CredentialFileAuth, AuthConfig, IAuthStrategy, ResolvedCredential, } from './auth.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,eAAe,EACf,UAAU,EACV,KAAK,GACN,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,YAAY,EACV,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,WAAW,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export { toolResultSchema } from './tool.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/types/provider.d.ts

@@ -0,0 +1,42 @@
+import type { ToolDescription } from './tool.js';
+export type MessageRole = 'user' | 'assistant' | 'system';
+export interface ToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: string;
+}
+export interface ToolResultMessage {
+    readonly toolCallId: string;
+    readonly content: string;
+}
+export interface Message {
+    readonly role: MessageRole;
+    readonly content: string;
+    readonly toolCalls?: readonly ToolCall[];
+    readonly toolResults?: readonly ToolResultMessage[];
+}
+export type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'error';
+export interface LlmResponse {
+    readonly content: string;
+    readonly stopReason: StopReason;
+    readonly toolCalls: readonly ToolCall[];
+    readonly usage: TokenUsage;
+}
+export interface TokenUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    /** Time spent in extended thinking / <think> block (ms). Only set by providers that support it. */
+    readonly thinkingMs?: number;
+}
+export interface StreamEvent {
+    readonly type: 'text_delta' | 'tool_call_start' | 'tool_call_delta' | 'done';
+    readonly content?: string;
+    readonly toolCall?: Partial<ToolCall>;
+    readonly response?: LlmResponse;
+}
+export interface ILlmProvider {
+    readonly providerId: string;
+    chat(messages: readonly Message[], tools?: readonly ToolDescription[]): Promise<LlmResponse>;
+    stream(messages: readonly Message[], tools?: readonly ToolDescription[]): AsyncIterable<StreamEvent>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/types/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/types/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACrD;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mGAAmG;IACnG,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,MAAM,CAAC;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7F,MAAM,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;CACtG"}

package/dist/types/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/types/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/types/provider.ts"],"names":[],"mappings":""}

package/dist/types/sandbox.d.ts

@@ -0,0 +1,27 @@
+export interface SandboxConfig {
+    readonly image: string;
+    readonly memoryLimitMb: number;
+    readonly cpuLimit: number;
+    readonly timeoutMs: number;
+    readonly workDir: string;
+}
+export interface ExecutionRequest {
+    readonly code: string;
+    readonly language: string;
+    readonly timeoutMs?: number;
+    readonly stdin?: string;
+}
+export interface ExecutionResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly timedOut: boolean;
+    readonly durationMs: number;
+}
+export interface ISandbox {
+    readonly containerId: string;
+    initialize(config: SandboxConfig): Promise<void>;
+    execute(request: ExecutionRequest): Promise<ExecutionResult>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/types/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/types/sandbox.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/types/sandbox.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sandbox.js.map

package/dist/types/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/types/sandbox.ts"],"names":[],"mappings":""}

package/dist/types/tool.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { JsonObject } from './common.js';
+import type { RunContext } from '../run-context.js';
+export interface ToolParameter {
+    readonly name: string;
+    readonly type: string;
+    readonly description: string;
+    readonly required: boolean;
+}
+export interface ToolDescription {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: readonly ToolParameter[];
+}
+export interface ToolResult {
+    readonly success: boolean;
+    readonly output: string;
+    readonly error?: string;
+    readonly metadata?: JsonObject;
+}
+export interface ITool {
+    readonly name: string;
+    readonly requiresPermission: boolean;
+    describe(): ToolDescription;
+    execute(params: JsonObject, context: RunContext): Promise<ToolResult>;
+}
+export declare const toolResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    output: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    output: string;
+    error?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    success: boolean;
+    output: string;
+    error?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/types/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,IAAI,eAAe,CAAC;IAC5B,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvE;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC"}

package/dist/types/tool.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export const toolResultSchema = z.object({
+    success: z.boolean(),
+    output: z.string(),
+    error: z.string().optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@charming_groot/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Core types, interfaces, and utilities for the CLI Agent framework",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "zod": "^3.22.0",
+    "pino": "^8.17.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0",
+    "@types/node": "^20.11.0"
+  },
+  "keywords": ["agent", "cli", "llm", "ai", "framework"],
+  "license": "MIT"
+}

package/src/config.ts

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { ConfigError } from './errors/base-error.js';
+
+const noAuthSchema = z.object({
+  type: z.literal('no-auth'),
+});
+
+const apiKeyAuthSchema = z.object({
+  type: z.literal('api-key'),
+  apiKey: z.string().min(1),
+});
+
+const oauthAuthSchema = z.object({
+  type: z.literal('oauth'),
+  clientId: z.string().min(1),
+  clientSecret: z.string().min(1),
+  tokenUrl: z.string().url(),
+  scopes: z.array(z.string()).optional(),
+  accessToken: z.string().optional(),
+  refreshToken: z.string().optional(),
+});
+
+const azureAdAuthSchema = z.object({
+  type: z.literal('azure-ad'),
+  tenantId: z.string().min(1),
+  clientId: z.string().min(1),
+  clientSecret: z.string().optional(),
+  accessToken: z.string().optional(),
+});
+
+const awsIamAuthSchema = z.object({
+  type: z.literal('aws-iam'),
+  accessKeyId: z.string().optional(),
+  secretAccessKey: z.string().optional(),
+  sessionToken: z.string().optional(),
+  region: z.string().min(1),
+  profile: z.string().optional(),
+});
+
+const gcpServiceAccountAuthSchema = z.object({
+  type: z.literal('gcp-service-account'),
+  projectId: z.string().min(1),
+  keyFilePath: z.string().optional(),
+  accessToken: z.string().optional(),
+});
+
+const credentialFileAuthSchema = z.object({
+  type: z.literal('credential-file'),
+  filePath: z.string().min(1),
+  profile: z.string().optional(),
+});
+
+export const authConfigSchema = z.discriminatedUnion('type', [
+  noAuthSchema,
+  apiKeyAuthSchema,
+  oauthAuthSchema,
+  azureAdAuthSchema,
+  awsIamAuthSchema,
+  gcpServiceAccountAuthSchema,
+  credentialFileAuthSchema,
+]);
+
+export const providerConfigSchema = z.object({
+  providerId: z.string().min(1),
+  model: z.string().min(1),
+  auth: authConfigSchema,
+  baseUrl: z.string().url().optional(),
+  maxTokens: z.number().int().positive().default(4096),
+  temperature: z.number().min(0).max(2).default(0.7),
+});
+
+export type ProviderConfig = z.infer<typeof providerConfigSchema>;
+
+export const sandboxConfigSchema = z.object({
+  image: z.string().default('node:20-slim'),
+  memoryLimitMb: z.number().int().positive().default(512),
+  cpuLimit: z.number().positive().default(1),
+  timeoutMs: z.number().int().positive().default(30000),
+  workDir: z.string().default('/workspace'),
+});
+
+export type SandboxConfigInput = z.infer<typeof sandboxConfigSchema>;
+
+export const agentConfigSchema = z.object({
+  provider: providerConfigSchema,
+  sandbox: sandboxConfigSchema.optional(),
+  maxIterations: z.number().int().positive().default(50),
+  systemPrompt: z.string().optional(),
+  workingDirectory: z.string().default(process.cwd()),
+});
+
+export type AgentConfig = z.infer<typeof agentConfigSchema>;
+
+export function parseConfig<T>(schema: z.ZodType<T, z.ZodTypeDef, unknown>, raw: unknown): T {
+  const result = schema.safeParse(raw);
+  if (!result.success) {
+    const messages = result.error.issues
+      .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+      .join('; ');
+    throw new ConfigError(`Invalid configuration: ${messages}`);
+  }
+  return result.data;
+}
+
+export function parseAgentConfig(raw: unknown): AgentConfig {
+  return parseConfig(agentConfigSchema, raw);
+}
+
+/**
+ * Shorthand: convert a plain apiKey string to an AuthConfig object.
+ * Useful for backward-compatible CLI usage.
+ */
+export function apiKeyAuth(apiKey: string): { type: 'api-key'; apiKey: string } {
+  return { type: 'api-key', apiKey };
+}
+
+export function noAuth(): { type: 'no-auth' } {
+  return { type: 'no-auth' };
+}

package/src/errors/base-error.ts

@@ -0,0 +1,66 @@
+export class AgentError extends Error {
+  readonly code: string;
+  readonly cause?: Error;
+
+  constructor(message: string, code: string, cause?: Error) {
+    super(message);
+    this.name = 'AgentError';
+    this.code = code;
+    this.cause = cause;
+  }
+}
+
+export class RegistryError extends AgentError {
+  constructor(message: string, cause?: Error) {
+    super(message, 'REGISTRY_ERROR', cause);
+    this.name = 'RegistryError';
+  }
+}
+
+export class ConfigError extends AgentError {
+  constructor(message: string, cause?: Error) {
+    super(message, 'CONFIG_ERROR', cause);
+    this.name = 'ConfigError';
+  }
+}
+
+export class ProviderError extends AgentError {
+  constructor(message: string, cause?: Error) {
+    super(message, 'PROVIDER_ERROR', cause);
+    this.name = 'ProviderError';
+  }
+}
+
+export class ToolExecutionError extends AgentError {
+  readonly toolName: string;
+
+  constructor(toolName: string, message: string, cause?: Error) {
+    super(message, 'TOOL_EXECUTION_ERROR', cause);
+    this.name = 'ToolExecutionError';
+    this.toolName = toolName;
+  }
+}
+
+export class SandboxError extends AgentError {
+  constructor(message: string, cause?: Error) {
+    super(message, 'SANDBOX_ERROR', cause);
+    this.name = 'SandboxError';
+  }
+}
+
+export class PermissionDeniedError extends AgentError {
+  readonly toolName: string;
+
+  constructor(toolName: string) {
+    super(`Permission denied for tool: ${toolName}`, 'PERMISSION_DENIED');
+    this.name = 'PermissionDeniedError';
+    this.toolName = toolName;
+  }
+}
+
+export class AbortError extends AgentError {
+  constructor(message = 'Operation aborted') {
+    super(message, 'ABORT_ERROR');
+    this.name = 'AbortError';
+  }
+}

package/src/errors/index.ts

@@ -0,0 +1,10 @@
+export {
+  AgentError,
+  RegistryError,
+  ConfigError,
+  ProviderError,
+  ToolExecutionError,
+  SandboxError,
+  PermissionDeniedError,
+  AbortError,
+} from './base-error.js';

package/src/event-bus.ts

@@ -0,0 +1,78 @@
+import type { EventName, EventPayload } from './types/events.js';
+
+type EventHandler<K extends EventName> = (payload: EventPayload<K>) => void;
+
+interface ListenerEntry {
+  readonly event: EventName;
+  readonly handler: EventHandler<EventName>;
+  readonly once: boolean;
+}
+
+export class EventBus {
+  private readonly listeners = new Map<EventName, ListenerEntry[]>();
+
+  on<K extends EventName>(event: K, handler: EventHandler<K>): () => void {
+    const entry: ListenerEntry = {
+      event,
+      handler: handler as EventHandler<EventName>,
+      once: false,
+    };
+    this.addListener(event, entry);
+    return () => this.removeListener(event, entry);
+  }
+
+  once<K extends EventName>(event: K, handler: EventHandler<K>): () => void {
+    const entry: ListenerEntry = {
+      event,
+      handler: handler as EventHandler<EventName>,
+      once: true,
+    };
+    this.addListener(event, entry);
+    return () => this.removeListener(event, entry);
+  }
+
+  emit<K extends EventName>(event: K, payload: EventPayload<K>): void {
+    const entries = this.listeners.get(event);
+    if (!entries) return;
+
+    const toRemove: ListenerEntry[] = [];
+    for (const entry of entries) {
+      entry.handler(payload as EventPayload<EventName>);
+      if (entry.once) {
+        toRemove.push(entry);
+      }
+    }
+
+    for (const entry of toRemove) {
+      this.removeListener(event, entry);
+    }
+  }
+
+  removeAllListeners(event?: EventName): void {
+    if (event) {
+      this.listeners.delete(event);
+    } else {
+      this.listeners.clear();
+    }
+  }
+
+  listenerCount(event: EventName): number {
+    return this.listeners.get(event)?.length ?? 0;
+  }
+
+  private addListener(event: EventName, entry: ListenerEntry): void {
+    const existing = this.listeners.get(event) ?? [];
+    this.listeners.set(event, [...existing, entry]);
+  }
+
+  private removeListener(event: EventName, entry: ListenerEntry): void {
+    const existing = this.listeners.get(event);
+    if (!existing) return;
+    const filtered = existing.filter((e) => e !== entry);
+    if (filtered.length === 0) {
+      this.listeners.delete(event);
+    } else {
+      this.listeners.set(event, filtered);
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,74 @@
+// Types
+export type {
+  JsonValue,
+  JsonObject,
+  Identifiable,
+  Timestamped,
+  Disposable,
+  ToolParameter,
+  ToolDescription,
+  ToolResult,
+  ITool,
+  MessageRole,
+  ToolCall,
+  ToolResultMessage,
+  Message,
+  StopReason,
+  LlmResponse,
+  TokenUsage,
+  StreamEvent,
+  ILlmProvider,
+  SandboxConfig,
+  ExecutionRequest,
+  ExecutionResult,
+  ISandbox,
+  AgentEvents,
+  EventName,
+  EventPayload,
+  AuthType,
+  NoAuth,
+  ApiKeyAuth,
+  OAuthAuth,
+  AzureAdAuth,
+  AwsIamAuth,
+  GcpServiceAccountAuth,
+  CredentialFileAuth,
+  AuthConfig,
+  IAuthStrategy,
+  ResolvedCredential,
+} from './types/index.js';
+export { toolResultSchema } from './types/index.js';
+
+// Core modules
+export { Registry } from './registry.js';
+export { EventBus } from './event-bus.js';
+export { RunContext } from './run-context.js';
+
+// Config
+export {
+  providerConfigSchema,
+  authConfigSchema,
+  sandboxConfigSchema,
+  agentConfigSchema,
+  parseConfig,
+  parseAgentConfig,
+  apiKeyAuth,
+  noAuth,
+} from './config.js';
+export type { ProviderConfig, SandboxConfigInput, AgentConfig } from './config.js';
+
+// Logger
+export { createLogger, createChildLogger, getRootLogger } from './logger.js';
+export type { LogLevel, AgentLogger } from './logger.js';
+
+// Errors
+export {
+  AgentError,
+  RegistryError,
+  ConfigError,
+  ProviderError,
+  ToolExecutionError,
+  SandboxError,
+  PermissionDeniedError,
+  AbortError,
+} from './errors/index.js';