@nexagent-cli/shared 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NexAgent Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @nexagent-cli/shared
+
+Shared types, constants, and utilities for the NexAgent monorepo.
+
+This package is automatically installed as a dependency of `@nexagent/cli`.

package/dist/constants/index.d.ts

@@ -0,0 +1,91 @@
+export declare const NEXAGENT_VERSION: "0.2.0";
+export declare const MIN_NODE_VERSION = 22;
+export declare const DATA_DIR_ENV = "NEXAGENT_DATA_DIR";
+export declare const CONFIG_FILE_NAME = "config.json";
+export declare const AGENT_DIR_NAME = "agents";
+export declare const DB_FILE_NAME = "nexagent.db";
+export declare const LOG_FILE_NAME = "nexagent.log";
+/** Default token budget allocation */
+export declare const TOKEN_BUDGET: {
+    readonly MEMORY_PERCENT: 0.35;
+    readonly TOOL_RESULTS_PERCENT: 0.25;
+    readonly RESPONSE_RESERVE_PERCENT: 0.2;
+};
+/** Safety Gate check order */
+export declare const SAFETY_CHECKS: readonly ["tool_exists", "tool_enabled", "schema_valid", "workspace_scope", "blocklist", "risk_level", "loop_guard", "rate_limit"];
+export type SafetyCheck = typeof SAFETY_CHECKS[number];
+/** Tool risk escalation thresholds */
+export declare const RISK_CONFIRM_THRESHOLD: Record<string, boolean>;
+/** Global blocklist — hardcoded, cannot be overridden */
+export declare const GLOBAL_SHELL_BLOCKLIST: readonly ["rm -rf /", "rm -rf ~", "mkfs", "dd if=/dev/zero", ":(){ :|:& };:", "format c:", "del /f /s /q c:\\"];
+/** Platform targets for the Go binary build */
+export declare const BUILD_TARGETS: readonly [{
+    readonly os: "linux";
+    readonly arch: "amd64";
+    readonly ext: "";
+}, {
+    readonly os: "linux";
+    readonly arch: "arm64";
+    readonly ext: "";
+}, {
+    readonly os: "darwin";
+    readonly arch: "amd64";
+    readonly ext: "";
+}, {
+    readonly os: "darwin";
+    readonly arch: "arm64";
+    readonly ext: "";
+}, {
+    readonly os: "windows";
+    readonly arch: "amd64";
+    readonly ext: ".exe";
+}];
+/** Ink TUI theme tokens */
+export declare const THEME: {
+    readonly dark: {
+        readonly primary: "#7C6EE6";
+        readonly secondary: "#4DBDFF";
+        readonly accent: "#FF7EFF";
+        readonly success: "#4DFFB4";
+        readonly warning: "#FFD066";
+        readonly error: "#FF6B6B";
+        readonly muted: "#6B7280";
+        readonly bg: "#0A0A0F";
+        readonly border: "#1E1E2E";
+        readonly text: "#E2E8F0";
+    };
+    readonly light: {
+        readonly primary: "#5046CC";
+        readonly secondary: "#0080CC";
+        readonly accent: "#CC00CC";
+        readonly success: "#00AA77";
+        readonly warning: "#BB8800";
+        readonly error: "#CC3333";
+        readonly muted: "#6B7280";
+        readonly bg: "#FAFAFA";
+        readonly border: "#E2E8F0";
+        readonly text: "#1A1A2E";
+    };
+};
+/** TUI Symbols */
+export declare const SYM: {
+    readonly AGENT: "◆";
+    readonly USER: "▸";
+    readonly TOOL: "⚙";
+    readonly MEMORY: "◉";
+    readonly SUCCESS: "✓";
+    readonly ERROR: "✗";
+    readonly WARNING: "⚠";
+    readonly ARROW: "→";
+    readonly DOTS: "…";
+    readonly SPIN: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    readonly BLOCK: "█";
+    readonly PARTIAL: "▓";
+    readonly LINE: "─";
+    readonly CORNER_TL: "╭";
+    readonly CORNER_TR: "╮";
+    readonly CORNER_BL: "╰";
+    readonly CORNER_BR: "╯";
+    readonly VERT: "│";
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AACjD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,YAAY,sBAAsB,CAAC;AAChD,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,cAAc,WAAW,CAAC;AACvC,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAC1C,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,sCAAsC;AACtC,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,8BAA8B;AAC9B,eAAO,MAAM,aAAa,oIAShB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvD,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAK1D,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,iHAQzB,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;EAMhB,CAAC;AAEX,2BAA2B;AAC3B,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;CAyBR,CAAC;AAEX,kBAAkB;AAClB,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;CAmBN,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,101 @@
+// ============================================================
+// Constants
+// ============================================================
+export const NEXAGENT_VERSION = '0.2.0';
+export const MIN_NODE_VERSION = 22;
+export const DATA_DIR_ENV = 'NEXAGENT_DATA_DIR';
+export const CONFIG_FILE_NAME = 'config.json';
+export const AGENT_DIR_NAME = 'agents';
+export const DB_FILE_NAME = 'nexagent.db';
+export const LOG_FILE_NAME = 'nexagent.log';
+/** Default token budget allocation */
+export const TOKEN_BUDGET = {
+    MEMORY_PERCENT: 0.35, // 35% of context window for memory blocks
+    TOOL_RESULTS_PERCENT: 0.25,
+    RESPONSE_RESERVE_PERCENT: 0.20,
+};
+/** Safety Gate check order */
+export const SAFETY_CHECKS = [
+    'tool_exists',
+    'tool_enabled',
+    'schema_valid',
+    'workspace_scope',
+    'blocklist',
+    'risk_level',
+    'loop_guard',
+    'rate_limit',
+];
+/** Tool risk escalation thresholds */
+export const RISK_CONFIRM_THRESHOLD = {
+    low: false,
+    medium: false,
+    high: true,
+    critical: true,
+};
+/** Global blocklist — hardcoded, cannot be overridden */
+export const GLOBAL_SHELL_BLOCKLIST = [
+    'rm -rf /',
+    'rm -rf ~',
+    'mkfs',
+    'dd if=/dev/zero',
+    ':(){ :|:& };:', // fork bomb
+    'format c:',
+    'del /f /s /q c:\\', // Windows destructive
+];
+/** Platform targets for the Go binary build */
+export const BUILD_TARGETS = [
+    { os: 'linux', arch: 'amd64', ext: '' },
+    { os: 'linux', arch: 'arm64', ext: '' },
+    { os: 'darwin', arch: 'amd64', ext: '' },
+    { os: 'darwin', arch: 'arm64', ext: '' },
+    { os: 'windows', arch: 'amd64', ext: '.exe' },
+];
+/** Ink TUI theme tokens */
+export const THEME = {
+    dark: {
+        primary: '#7C6EE6',
+        secondary: '#4DBDFF',
+        accent: '#FF7EFF',
+        success: '#4DFFB4',
+        warning: '#FFD066',
+        error: '#FF6B6B',
+        muted: '#6B7280',
+        bg: '#0A0A0F',
+        border: '#1E1E2E',
+        text: '#E2E8F0',
+    },
+    light: {
+        primary: '#5046CC',
+        secondary: '#0080CC',
+        accent: '#CC00CC',
+        success: '#00AA77',
+        warning: '#BB8800',
+        error: '#CC3333',
+        muted: '#6B7280',
+        bg: '#FAFAFA',
+        border: '#E2E8F0',
+        text: '#1A1A2E',
+    },
+};
+/** TUI Symbols */
+export const SYM = {
+    AGENT: '◆',
+    USER: '▸',
+    TOOL: '⚙',
+    MEMORY: '◉',
+    SUCCESS: '✓',
+    ERROR: '✗',
+    WARNING: '⚠',
+    ARROW: '→',
+    DOTS: '…',
+    SPIN: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+    BLOCK: '█',
+    PARTIAL: '▓',
+    LINE: '─',
+    CORNER_TL: '╭',
+    CORNER_TR: '╮',
+    CORNER_BL: '╰',
+    CORNER_BR: '╯',
+    VERT: '│',
+};
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types/agent.js';
+export * from './types/tool.js';
+export * from './types/memory.js';
+export * from './types/llm.js';
+export * from './types/session.js';
+export * from './types/config.js';
+export * from './types/events.js';
+export * from './constants/index.js';
+export * from './utils/result.js';
+export * from './utils/id.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// ============================================================
+// @nexagent-cli/shared — root barrel export
+// All cross-package types, constants, and utilities live here.
+// ============================================================
+export * from './types/agent.js';
+export * from './types/tool.js';
+export * from './types/memory.js';
+export * from './types/llm.js';
+export * from './types/session.js';
+export * from './types/config.js';
+export * from './types/events.js';
+export * from './constants/index.js';
+export * from './utils/result.js';
+export * from './utils/id.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,4CAA4C;AAC5C,+DAA+D;AAC/D,+DAA+D;AAE/D,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/types/agent.d.ts

@@ -0,0 +1,47 @@
+export type AgentStatus = 'idle' | 'thinking' | 'tool_call' | 'tool_result' | 'streaming' | 'waiting_confirmation' | 'error' | 'done';
+export interface AgentConfig {
+    name: string;
+    model: string;
+    provider: LLMProviderName;
+    systemPromptExtra?: string;
+    maxTurns: number;
+    maxTokensPerTurn: number;
+    temperature: number;
+    workspaceDir: string;
+    memoryEnabled: boolean;
+    subagentsEnabled: boolean;
+    safetyLevel: SafetyLevel;
+    allowedTools: string[];
+    blockedTools: string[];
+}
+export type LLMProviderName = 'openai' | 'anthropic' | 'google' | 'ollama' | 'openai-compatible';
+export type SafetyLevel = 'strict' | 'standard' | 'permissive';
+export interface AgentTurn {
+    id: string;
+    sessionId: string;
+    role: 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCalls?: ToolCallRecord[];
+    toolResults?: ToolResultRecord[];
+    model?: string;
+    tokensIn?: number;
+    tokensOut?: number;
+    costUsd?: number;
+    createdAt: number;
+}
+export interface ToolCallRecord {
+    id: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    startedAt: number;
+}
+export interface ToolResultRecord {
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+    error?: string;
+    durationMs: number;
+    riskLevel: RiskLevel;
+}
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,UAAU,GACV,WAAW,GACX,aAAa,GACb,WAAW,GACX,sBAAsB,GACtB,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,mBAAmB,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC"}

package/dist/types/agent.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Agent core types
+// ============================================================
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D"}

package/dist/types/config.d.ts

@@ -0,0 +1,60 @@
+import type { LLMProviderName, SafetyLevel } from './agent.js';
+export interface NexAgentConfig {
+    version: 1;
+    defaultAgent: string;
+    providers: ProvidersConfig;
+    defaults: AgentDefaults;
+    ui: UIConfig;
+    telemetry: TelemetryConfig;
+}
+export interface ProvidersConfig {
+    openai?: {
+        apiKey: string;
+        baseUrl?: string;
+        defaultModel: string;
+    };
+    anthropic?: {
+        apiKey: string;
+        defaultModel: string;
+    };
+    google?: {
+        apiKey: string;
+        defaultModel: string;
+    };
+    ollama?: {
+        baseUrl: string;
+        defaultModel: string;
+    };
+    'openai-compatible'?: {
+        apiKey: string;
+        baseUrl: string;
+        defaultModel: string;
+    };
+}
+export interface AgentDefaults {
+    model: string;
+    provider: LLMProviderName;
+    maxTurns: number;
+    temperature: number;
+    safetyLevel: SafetyLevel;
+    memoryEnabled: boolean;
+    subagentsEnabled: boolean;
+}
+export interface UIConfig {
+    theme: 'dark' | 'light' | 'system';
+    compactMode: boolean;
+    showTokenCounts: boolean;
+    showCostEstimates: boolean;
+    animationsEnabled: boolean;
+    confirmHighRisk: boolean;
+    confirmCritical: boolean;
+}
+export interface TelemetryConfig {
+    enabled: boolean;
+    anonymousUsage: boolean;
+}
+/** Partial config for user overrides — all fields optional */
+export type UserConfig = Partial<Omit<NexAgentConfig, 'version'>>;
+/** Resolved config after merging defaults + user config */
+export type ResolvedConfig = NexAgentConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,aAAa,CAAC;IACxB,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,mBAAmB,CAAC,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;AAElE,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Configuration types
+// ============================================================
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,sBAAsB;AACtB,+DAA+D"}

package/dist/types/events.d.ts

@@ -0,0 +1,64 @@
+import type { AgentStatus, ToolCallRecord, ToolResultRecord } from './agent.js';
+/** All agent events that the TUI subscribes to */
+export type AgentEventMap = {
+    'status:change': {
+        status: AgentStatus;
+        message?: string;
+    };
+    'stream:text': {
+        text: string;
+    };
+    'stream:done': {
+        fullText: string;
+    };
+    'tool:start': ToolCallRecord;
+    'tool:result': ToolResultRecord;
+    'tool:blocked': {
+        toolName: string;
+        reason: string;
+    };
+    'memory:read': {
+        blockIds: string[];
+        tokenCount: number;
+    };
+    'memory:write': {
+        blockId: string;
+        blockType: string;
+    };
+    'subagent:spawn': {
+        subagentType: string;
+        reason: string;
+    };
+    'subagent:done': {
+        subagentType: string;
+        proposalCount: number;
+    };
+    'session:start': {
+        sessionId: string;
+    };
+    'session:end': {
+        sessionId: string;
+        turnCount: number;
+        costUsd: number;
+    };
+    'error': {
+        message: string;
+        code?: string;
+        recoverable: boolean;
+    };
+    'confirmation:request': {
+        prompt: string;
+        toolName: string;
+        riskLevel: string;
+    };
+    'confirmation:response': {
+        approved: boolean;
+    };
+    'undo:available': {
+        undoId: string;
+        description: string;
+    };
+};
+export type AgentEventName = keyof AgentEventMap;
+export type AgentEvent<K extends AgentEventName> = AgentEventMap[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":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,YAAY,EAAE,cAAc,CAAC;IAC7B,aAAa,EAAE,gBAAgB,CAAC;IAChC,cAAc,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,cAAc,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,gBAAgB,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,eAAe,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,eAAe,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,aAAa,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAClE,sBAAsB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,uBAAuB,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC;AACjD,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,cAAc,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/events.js

@@ -0,0 +1,6 @@
+// ============================================================
+// Event bus types — used for agent ↔ TUI communication
+// All events flow through a typed EventEmitter
+// ============================================================
+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":"AAAA,+DAA+D;AAC/D,uDAAuD;AACvD,+CAA+C;AAC/C,+DAA+D"}

package/dist/types/llm.d.ts

@@ -0,0 +1,70 @@
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCallId?: string;
+    name?: string;
+    /** For assistant messages that made tool calls — needed for multi-turn */
+    toolCalls?: LLMToolCall[];
+}
+export interface LLMToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface LLMRequestOptions {
+    model: string;
+    messages: LLMMessage[];
+    tools?: LLMToolDefinition[];
+    toolChoice?: 'auto' | 'none' | 'required';
+    temperature?: number;
+    maxTokens?: number;
+    stream?: boolean;
+}
+export interface LLMToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMResponse {
+    id: string;
+    model: string;
+    content: string;
+    toolCalls?: LLMToolCall[];
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        costUsd: number;
+    };
+}
+export interface LLMStreamChunk {
+    type: 'text' | 'tool_call_start' | 'tool_call_delta' | 'tool_call_end' | 'done';
+    text?: string;
+    toolCallId?: string;
+    toolName?: string;
+    argsDelta?: string;
+    finishReason?: string;
+}
+export interface LLMCapabilities {
+    supportsFunctionCalling: boolean;
+    supportsStreaming: boolean;
+    supportsVision: boolean;
+    contextWindow: number;
+    maxOutputTokens: number;
+}
+export interface LLMProvider {
+    name: string;
+    complete(options: LLMRequestOptions): Promise<LLMResponse>;
+    stream(options: LLMRequestOptions): AsyncGenerator<LLMStreamChunk>;
+    countTokens(text: string, model: string): number;
+    getCapabilities(model: string): LLMCapabilities;
+    listModels(): Promise<string[]>;
+}
+//# sourceMappingURL=llm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/types/llm.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,GAAG,MAAM,CAAC;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,OAAO,CAAC;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;IAChD,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACjC"}

package/dist/types/llm.js

@@ -0,0 +1,5 @@
+// ============================================================
+// LLM Router types
+// ============================================================
+export {};
+//# sourceMappingURL=llm.js.map

package/dist/types/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/types/llm.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D"}

package/dist/types/memory.d.ts

@@ -0,0 +1,40 @@
+export type MemoryBlockType = 'persona' | 'user_profile' | 'task_context' | 'learned_facts' | 'skill_preferences' | 'conversation_summary' | 'custom';
+export interface MemoryBlock {
+    id: string;
+    blockType: MemoryBlockType;
+    content: string;
+    version: number;
+    tokenEstimate: number;
+    updatedAt: number;
+    pinned: boolean;
+    archived: boolean;
+    tags: string[];
+}
+export interface VectorRecord {
+    id: string;
+    blockId: string;
+    chunkIndex: number;
+    chunkText: string;
+    embedding: number[];
+    model: string;
+    createdAt: number;
+}
+export interface MemoryReadOptions {
+    semanticQuery?: string;
+    includeArchived?: boolean;
+    limit?: number;
+    tokenBudget?: number;
+    pinFirst?: boolean;
+}
+export interface MemoryWriteProposal {
+    id: string;
+    sessionId: string;
+    blockId?: string;
+    blockType: MemoryBlockType;
+    proposedContent: string;
+    rationale: string;
+    proposedBy: 'skill_scanner' | 'prompt_improver' | 'context_refiner' | 'user';
+    status: 'pending' | 'approved' | 'rejected';
+    createdAt: number;
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,cAAc,GACd,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,sBAAsB,GACtB,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,MAAM,CAAC;IAC7E,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/memory.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Memory system types
+// ============================================================
+export {};
+//# sourceMappingURL=memory.js.map

package/dist/types/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,sBAAsB;AACtB,+DAA+D"}

package/dist/types/session.d.ts

@@ -0,0 +1,28 @@
+export type SessionStatus = 'active' | 'completed' | 'error' | 'interrupted';
+export interface Session {
+    id: string;
+    agentName: string;
+    model: string;
+    cwd: string;
+    startedAt: number;
+    endedAt?: number;
+    turnCount: number;
+    status: SessionStatus;
+    totalCostUsd: number;
+    totalTokensIn: number;
+    totalTokensOut: number;
+}
+export interface UndoEntry {
+    id: string;
+    sessionId: string;
+    toolName: string;
+    operation: string;
+    filePath?: string;
+    originalContent?: string;
+    createdAt: number;
+}
+export interface SessionSummary extends Session {
+    firstUserMessage?: string;
+    lastAssistantMessage?: string;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;AAE7E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/types/session.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Session types
+// ============================================================
+export {};
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D"}

package/dist/types/tool.d.ts

@@ -0,0 +1,87 @@
+import type { RiskLevel } from './agent.js';
+/** JSON Schema subset for tool parameter definitions */
+export interface JSONSchemaObject {
+    type: 'object';
+    properties: Record<string, JSONSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+export type JSONSchemaProperty = {
+    type: 'string';
+    description?: string;
+    enum?: string[];
+} | {
+    type: 'number';
+    description?: string;
+    minimum?: number;
+    maximum?: number;
+} | {
+    type: 'boolean';
+    description?: string;
+} | {
+    type: 'array';
+    items: JSONSchemaProperty;
+    description?: string;
+} | {
+    type: 'object';
+    properties?: Record<string, JSONSchemaProperty>;
+    description?: string;
+};
+/** Permissions a tool may require */
+export type Permission = 'fs:read' | 'fs:write' | 'fs:delete' | 'shell:exec' | 'network:fetch' | 'memory:read' | 'memory:write' | 'process:spawn';
+/** Execution context passed to every tool */
+export interface ToolContext {
+    sessionId: string;
+    workspaceDir: string;
+    agentName: string;
+    dryRun: boolean;
+    confirmFn: (prompt: string) => Promise<boolean>;
+    emit: (event: string, data: unknown) => void;
+    /** Duck-typed MemoryManager.read() for tools that need memory access */
+    memory?: {
+        read: (opts: any) => Promise<any[]>;
+    };
+    /** better-sqlite3 Database for direct SQL access (e.g. undo persistence) */
+    db?: any;
+}
+/** What every tool must return */
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    data?: unknown;
+    executionId: string;
+    durationMs: number;
+    bytesRead?: number;
+    bytesWritten?: number;
+}
+/** The canonical Tool interface */
+export interface Tool {
+    name: string;
+    version: string;
+    description: string;
+    parameters: JSONSchemaObject;
+    permissions: readonly Permission[];
+    riskLevel: RiskLevel;
+    enabled: boolean;
+    /** Primary execution path */
+    execute(args: unknown, context: ToolContext): Promise<ToolResult>;
+    /** Returns a description of what WOULD happen — no side effects */
+    dryRun?(args: unknown, context: ToolContext): Promise<string>;
+    /** Reverses a previous execution by executionId */
+    undo?(executionId: string, context: ToolContext): Promise<void>;
+}
+/** Registry entry with metadata */
+export interface ToolRegistryEntry {
+    tool: Tool;
+    registeredAt: number;
+    callCount: number;
+    lastCalledAt?: number;
+}
+/** Safety Gate verdict */
+export interface SafetyVerdict {
+    allowed: boolean;
+    reason?: string;
+    checkFailed?: string;
+    suggestedAlternative?: string;
+}
+//# 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":"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"}

package/dist/types/tool.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Tool system types — canonical Tool contract
+// ============================================================
+export {};
+//# 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,+DAA+D;AAC/D,8CAA8C;AAC9C,+DAA+D"}

package/dist/utils/id.d.ts

@@ -0,0 +1,5 @@
+/** Generate a UUID v4 */
+export declare function generateId(): string;
+/** Short 8-char ID for display purposes */
+export declare function shortId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAKA,yBAAyB;AACzB,wBAAgB,UAAU,IAAI,MAAM,CAYnC;AAED,2CAA2C;AAC3C,wBAAgB,OAAO,IAAI,MAAM,CAEhC"}

package/dist/utils/id.js

@@ -0,0 +1,23 @@
+// ============================================================
+// ID generation — crypto-random, no external deps
+// ============================================================
+import { randomBytes } from 'node:crypto';
+/** Generate a UUID v4 */
+export function generateId() {
+    const bytes = randomBytes(16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4
+    bytes[8] = (bytes[8] & 0x3f) | 0x80; // variant
+    const hex = bytes.toString('hex');
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20),
+    ].join('-');
+}
+/** Short 8-char ID for display purposes */
+export function shortId() {
+    return randomBytes(4).toString('hex');
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kDAAkD;AAClD,+DAA+D;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,yBAAyB;AACzB,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,YAAY;IAClD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,UAAU;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAChB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;KACd,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,OAAO;IACrB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/utils/result.d.ts

@@ -0,0 +1,16 @@
+export type Ok<T> = {
+    ok: true;
+    value: T;
+};
+export type Err<E> = {
+    ok: false;
+    error: E;
+};
+export type Result<T, E = Error> = Ok<T> | Err<E>;
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<E>(error: E): Err<E>;
+export declare function isOk<T, E>(r: Result<T, E>): r is Ok<T>;
+export declare function isErr<T, E>(r: Result<T, E>): r is Err<E>;
+export declare function unwrap<T, E>(r: Result<T, E>): T;
+export declare function unwrapOr<T, E>(r: Result<T, E>, fallback: T): T;
+//# sourceMappingURL=result.d.ts.map

package/dist/utils/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAC7C,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAElD,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAEvC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAEtD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAExD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAG/C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAE9D"}

package/dist/utils/result.js

@@ -0,0 +1,24 @@
+// ============================================================
+// Result<T, E> — typed error handling without exceptions
+// ============================================================
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+export function isOk(r) {
+    return r.ok;
+}
+export function isErr(r) {
+    return !r.ok;
+}
+export function unwrap(r) {
+    if (!r.ok)
+        throw r.error;
+    return r.value;
+}
+export function unwrapOr(r, fallback) {
+    return r.ok ? r.value : fallback;
+}
+//# sourceMappingURL=result.js.map

package/dist/utils/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,yDAAyD;AACzD,+DAA+D;AAM/D,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,IAAI,CAAO,CAAe;IACxC,OAAO,CAAC,CAAC,EAAE,CAAC;AACd,CAAC;AAED,MAAM,UAAU,KAAK,CAAO,CAAe;IACzC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACf,CAAC;AAED,MAAM,UAAU,MAAM,CAAO,CAAe;IAC1C,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,MAAM,CAAC,CAAC,KAAK,CAAC;IACzB,OAAO,CAAC,CAAC,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAO,CAAe,EAAE,QAAW;IACzD,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@nexagent-cli/shared",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Shared types, constants, and utilities for NexAgent",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist/",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}