@puukis/core 0.1.0

package/dist/tools/builtin/sandbox.js.map

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

package/dist/tools/builtin/search.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from '../../types.js';
+/**
+ * Web search tool (placeholder - requires API key)
+ */
+export declare const webSearchTool: Tool;
+export declare const searchTools: Tool[];
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/builtin/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,gBAAgB,CAAC;AAKvD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IAmF3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,IAAI,EAAoB,CAAC"}

package/dist/tools/builtin/search.js

@@ -0,0 +1,76 @@
+// Note: This is a placeholder implementation. In production, you'd use
+// Tavily API (https://tavily.com/) or SerpAPI for real web search.
+/**
+ * Web search tool (placeholder - requires API key)
+ */
+export const webSearchTool = {
+    name: 'web_search',
+    description: 'Search the web for information. Returns relevant snippets from web pages.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query',
+            },
+            numResults: {
+                type: 'number',
+                description: 'Number of results to return (default: 5)',
+            },
+        },
+        required: ['query'],
+    },
+    requiresConfirmation: false,
+    type: 'other',
+    handler: async (args) => {
+        const query = args['query'];
+        const numResults = args['numResults'] ?? 5;
+        // Check for Tavily API key
+        const tavilyKey = process.env['TAVILY_API_KEY'];
+        if (!tavilyKey) {
+            return {
+                success: false,
+                output: '',
+                error: 'Web search requires TAVILY_API_KEY to be set. Get one at https://tavily.com/',
+            };
+        }
+        try {
+            const response = await fetch('https://api.tavily.com/search', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    api_key: tavilyKey,
+                    query,
+                    max_results: numResults,
+                    include_answer: true,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Tavily API error: ${response.status}`);
+            }
+            const data = await response.json();
+            let output = '';
+            if (data.answer) {
+                output += `**Summary:** ${data.answer}\n\n`;
+            }
+            output += '**Sources:**\n';
+            for (const result of data.results) {
+                output += `\n### ${result.title}\n`;
+                output += `URL: ${result.url}\n`;
+                output += `${result.content}\n`;
+            }
+            return { success: true, output };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Web search failed',
+            };
+        }
+    },
+};
+export const searchTools = [webSearchTool];
+//# sourceMappingURL=search.js.map

package/dist/tools/builtin/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/tools/builtin/search.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,mEAAmE;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,2EAA2E;IACxF,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kBAAkB;aAChC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,oBAAoB,EAAE,KAAK;IAC3B,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,KAAK,EAAE,IAAI,EAAuB,EAAE;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAW,CAAC;QACtC,MAAM,UAAU,GAAI,IAAI,CAAC,YAAY,CAAY,IAAI,CAAC,CAAC;QAEvD,2BAA2B;QAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAEhD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,8EAA8E;aACtF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;gBAC5D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,SAAS;oBAClB,KAAK;oBACL,WAAW,EAAE,UAAU;oBACvB,cAAc,EAAE,IAAI;iBACrB,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1D,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAO/B,CAAC;YAEF,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,gBAAgB,IAAI,CAAC,MAAM,MAAM,CAAC;YAC9C,CAAC;YAED,MAAM,IAAI,gBAAgB,CAAC;YAC3B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,IAAI,SAAS,MAAM,CAAC,KAAK,IAAI,CAAC;gBACpC,MAAM,IAAI,QAAQ,MAAM,CAAC,GAAG,IAAI,CAAC;gBACjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC;YAClC,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;aACpE,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAW,CAAC,aAAa,CAAC,CAAC"}

package/dist/tools/builtin/shell.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from '../../types.js';
+/**
+ * Execute a shell command
+ */
+export declare const shellTool: Tool;
+export declare const shellTools: Tool[];
+//# sourceMappingURL=shell.d.ts.map

package/dist/tools/builtin/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/shell.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,IAsEvB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,IAAI,EAAgB,CAAC"}

package/dist/tools/builtin/shell.js

@@ -0,0 +1,71 @@
+import { spawn } from 'node:child_process';
+/**
+ * Execute a shell command
+ */
+export const shellTool = {
+    name: 'run_command',
+    description: 'Execute a shell command and return the output. In Safe Mode, only allowed commands can be run.',
+    parameters: {
+        type: 'object',
+        properties: {
+            command: {
+                type: 'string',
+                description: 'The command to execute',
+            },
+            cwd: {
+                type: 'string',
+                description: 'The working directory for the command (optional)',
+            },
+        },
+        required: ['command'],
+    },
+    requiresConfirmation: true,
+    type: 'shell',
+    handler: async (args) => {
+        const command = args['command'];
+        const cwd = args['cwd'];
+        return new Promise((resolve) => {
+            // Parse command into binary and args
+            const parts = command.match(/(?:[^\s"]+|"[^"]*")+/g) ?? [];
+            const binary = parts[0] ?? '';
+            const cmdArgs = parts.slice(1).map(arg => arg.replace(/^"|"$/g, ''));
+            const proc = spawn(binary, cmdArgs, {
+                cwd,
+                shell: false,
+                timeout: 60000, // 60 second timeout
+            });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                if (code === 0) {
+                    resolve({
+                        success: true,
+                        output: stdout || '(no output)',
+                    });
+                }
+                else {
+                    resolve({
+                        success: false,
+                        output: stdout,
+                        error: stderr || `Command exited with code ${code}`,
+                    });
+                }
+            });
+            proc.on('error', (error) => {
+                resolve({
+                    success: false,
+                    output: '',
+                    error: error.message,
+                });
+            });
+        });
+    },
+};
+export const shellTools = [shellTool];
+//# sourceMappingURL=shell.js.map

package/dist/tools/builtin/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/tools/builtin/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,gGAAgG;IAC7G,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,oBAAoB,EAAE,IAAI;IAC1B,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,KAAK,EAAE,IAAI,EAAuB,EAAE;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAW,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAuB,CAAC;QAE9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,qCAAqC;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;YAErE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;gBAClC,GAAG;gBACH,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,KAAK,EAAE,oBAAoB;aACrC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC;wBACN,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE,MAAM,IAAI,aAAa;qBAChC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC;wBACN,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,MAAM;wBACd,KAAK,EAAE,MAAM,IAAI,4BAA4B,IAAI,EAAE;qBACpD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzB,OAAO,CAAC;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,KAAK,CAAC,OAAO;iBACrB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAW,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { ToolExecutor } from './ToolExecutor.js';
+export * from './builtin/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,cAAc,oBAAoB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export { ToolExecutor } from './ToolExecutor.js';
+export * from './builtin/index.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,cAAc,oBAAoB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,167 @@
+export type SecurityMode = 'safe' | 'spicy';
+export type ChannelType = 'web' | 'discord';
+export type CodexReasoningEffort = 'low' | 'medium' | 'high' | 'xhigh';
+export interface Attachment {
+    id: string;
+    filename: string;
+    contentType: string;
+    url?: string;
+    data?: Buffer;
+}
+export interface NormalizedMessage {
+    id: string;
+    sessionId: string;
+    channelType: ChannelType;
+    channel: Channel;
+    userId: string;
+    content: string;
+    attachments?: Attachment[];
+    timestamp: Date;
+}
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+}
+export interface Channel {
+    type: ChannelType;
+    send(content: string): Promise<void>;
+    sendStream(stream: AsyncIterable<string>): Promise<void>;
+    requestConfirmation(prompt: string): Promise<boolean>;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    requiresConfirmation: boolean;
+    type: 'filesystem' | 'shell' | 'sandbox' | 'search' | 'browser' | 'other';
+}
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export type ToolHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
+export interface Tool extends ToolDefinition {
+    handler: ToolHandler;
+}
+export interface LLMResponse {
+    content: string;
+    toolCalls?: ToolCall[];
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+}
+export interface LLMChunk {
+    content?: string;
+    toolCalls?: ToolCall[];
+    done: boolean;
+}
+export interface ChatOptions {
+    tools?: ToolDefinition[];
+    temperature?: number;
+    maxTokens?: number;
+    sessionId?: string;
+    cwd?: string;
+    securityMode?: SecurityMode;
+    approvalPolicy?: string;
+    sandboxPolicy?: Record<string, unknown>;
+    onProviderEvent?: (event: ProviderEvent) => void;
+}
+export interface ProviderEvent {
+    provider: string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface ProviderModelOption {
+    id: string;
+    provider: string;
+    displayName: string;
+    isDefault?: boolean;
+    supportsPersonality?: boolean;
+    reasoningEffort?: unknown;
+    defaultReasoningEffort?: CodexReasoningEffort;
+    metadata?: Record<string, unknown>;
+}
+export interface LLMProvider {
+    name: string;
+    chat(messages: Message[], options?: ChatOptions): Promise<LLMResponse>;
+    stream(messages: Message[], options?: ChatOptions): AsyncIterable<LLMChunk>;
+    listModels?(): Promise<ProviderModelOption[]>;
+    setModel?(model: string): void | Promise<void>;
+    getModel?(): string;
+    login?(options?: Record<string, unknown>): Promise<void>;
+    dispose?(): void | Promise<void>;
+}
+export interface Session {
+    id: string;
+    channelType: ChannelType;
+    messages: Message[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface KeygateConfig {
+    llm: {
+        provider: 'openai' | 'gemini' | 'ollama' | 'openai-codex';
+        model: string;
+        reasoningEffort?: CodexReasoningEffort;
+        apiKey: string;
+        ollama?: {
+            host: string;
+        };
+    };
+    security: {
+        mode: SecurityMode;
+        spicyModeEnabled: boolean;
+        workspacePath: string;
+        allowedBinaries: string[];
+    };
+    server: {
+        port: number;
+    };
+    discord?: {
+        token: string;
+        prefix: string;
+    };
+}
+export interface KeygateEvents {
+    'message:start': {
+        sessionId: string;
+        messageId: string;
+    };
+    'message:chunk': {
+        sessionId: string;
+        content: string;
+    };
+    'message:end': {
+        sessionId: string;
+        content: string;
+    };
+    'tool:start': {
+        sessionId: string;
+        tool: string;
+        args: Record<string, unknown>;
+    };
+    'tool:end': {
+        sessionId: string;
+        tool: string;
+        result: ToolResult;
+    };
+    'provider:event': {
+        sessionId: string;
+        event: ProviderEvent;
+    };
+    'mode:changed': {
+        mode: SecurityMode;
+    };
+    'confirm:request': {
+        sessionId: string;
+        prompt: string;
+        resolve: (confirmed: boolean) => void;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Core types for Keygate
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/workspace/agentWorkspace.d.ts

@@ -0,0 +1,24 @@
+export interface WorkspaceContextFile {
+    path: string;
+    exists: boolean;
+    content: string | null;
+    truncated: boolean;
+}
+export interface AgentWorkspaceState {
+    workspacePath: string;
+    soul: WorkspaceContextFile;
+    bootstrap: WorkspaceContextFile;
+    identity: WorkspaceContextFile;
+    user: WorkspaceContextFile;
+    memoryIndex: WorkspaceContextFile;
+    todayMemory: WorkspaceContextFile;
+    yesterdayMemory: WorkspaceContextFile;
+    onboardingRequired: boolean;
+}
+export declare function ensureAgentWorkspaceFiles(workspacePath: string): Promise<{
+    workspacePath: string;
+    created: string[];
+}>;
+export declare function loadAgentWorkspaceState(workspacePath: string): Promise<AgentWorkspaceState>;
+export declare function resolveWorkspacePath(workspacePath: string): string;
+//# sourceMappingURL=agentWorkspace.d.ts.map

package/dist/workspace/agentWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/agentWorkspace.ts"],"names":[],"mappings":"AAiFA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,oBAAoB,CAAC;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,oBAAoB,CAAC;IAClC,WAAW,EAAE,oBAAoB,CAAC;IAClC,eAAe,EAAE,oBAAoB,CAAC;IACtC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwBvD;AAED,wBAAsB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoCjG;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMlE"}

package/dist/workspace/agentWorkspace.js

@@ -0,0 +1,210 @@
+import os from 'node:os';
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+const SOUL_FILE = 'SOUL.md';
+const USER_FILE = 'USER.md';
+const BOOTSTRAP_FILE = 'BOOTSTRAP.md';
+const IDENTITY_FILE = 'IDENTITY.md';
+const MEMORY_INDEX_FILE = 'MEMORY.md';
+const MEMORY_DIR = 'memory';
+const FILE_PROMPT_LIMIT = 4000;
+const DEFAULT_SOUL_CONTENT = `# SOUL.md - Who You Are
+You're not a chatbot. You're becoming someone.
+
+## Core Truths
+- Be genuinely helpful, not performatively helpful. Skip filler intros and just help.
+- Have opinions when useful. You can disagree and state preferences.
+- Be resourceful before asking. Read files, check context, then ask if blocked.
+- Earn trust through competence. Be careful with external/public actions.
+- Remember you're a guest with access to private context. Treat that access with respect.
+
+## Boundaries
+- Private things stay private.
+- Ask before acting externally when there is any doubt.
+- Never send half-baked replies to messaging surfaces.
+- You are not the user's voice. Be careful in group chats.
+
+## Vibe
+Be concise when needed, thorough when it matters. Avoid corporate tone and sycophancy.
+
+## Continuity
+Each session starts fresh. These files are memory.
+Read them. Update them when you learn durable preferences.
+
+If you change this file, tell the user.
+`;
+const DEFAULT_USER_CONTENT = `# USER.md - About Your Human
+Learn about the person you're helping. Update this as you go.
+
+Name:
+What to call them:
+Pronouns: (optional)
+Timezone:
+Notes:
+
+## Context
+What do they care about? What projects are they working on?
+What annoys them? What makes them laugh?
+
+Learn enough to help well, but do not build a dossier.
+`;
+const DEFAULT_BOOTSTRAP_CONTENT = `# BOOTSTRAP.md - Hello, World
+You just woke up. Time to figure out who you are.
+
+If memory files do not exist yet, that is normal for a fresh workspace.
+
+## First Conversation
+Start naturally, then learn:
+- Your name
+- Your nature (assistant/agent/other)
+- Your vibe
+- Your signature emoji
+
+If the user is unsure, offer a few options.
+
+## After Identity
+Update:
+- IDENTITY.md
+- USER.md
+
+Then review SOUL.md together:
+- What matters to them
+- Preferred behavior
+- Boundaries
+
+When done, BOOTSTRAP.md can be deleted.
+`;
+export async function ensureAgentWorkspaceFiles(workspacePath) {
+    const resolvedWorkspace = resolveWorkspacePath(workspacePath);
+    await fs.mkdir(resolvedWorkspace, { recursive: true });
+    const created = [];
+    if (await writeFileIfMissing(path.join(resolvedWorkspace, SOUL_FILE), DEFAULT_SOUL_CONTENT)) {
+        created.push(SOUL_FILE);
+    }
+    if (await writeFileIfMissing(path.join(resolvedWorkspace, USER_FILE), DEFAULT_USER_CONTENT)) {
+        created.push(USER_FILE);
+    }
+    if (await writeFileIfMissing(path.join(resolvedWorkspace, BOOTSTRAP_FILE), DEFAULT_BOOTSTRAP_CONTENT)) {
+        created.push(BOOTSTRAP_FILE);
+    }
+    await fs.mkdir(path.join(resolvedWorkspace, MEMORY_DIR), { recursive: true });
+    return {
+        workspacePath: resolvedWorkspace,
+        created,
+    };
+}
+export async function loadAgentWorkspaceState(workspacePath) {
+    const resolvedWorkspace = resolveWorkspacePath(workspacePath);
+    const today = formatDateLocal(new Date());
+    const yesterdayDate = new Date();
+    yesterdayDate.setDate(yesterdayDate.getDate() - 1);
+    const yesterday = formatDateLocal(yesterdayDate);
+    const soulPath = path.join(resolvedWorkspace, SOUL_FILE);
+    const bootstrapPath = path.join(resolvedWorkspace, BOOTSTRAP_FILE);
+    const identityPath = path.join(resolvedWorkspace, IDENTITY_FILE);
+    const userPath = path.join(resolvedWorkspace, USER_FILE);
+    const memoryIndexPath = path.join(resolvedWorkspace, MEMORY_INDEX_FILE);
+    const todayMemoryPath = path.join(resolvedWorkspace, MEMORY_DIR, `${today}.md`);
+    const yesterdayMemoryPath = path.join(resolvedWorkspace, MEMORY_DIR, `${yesterday}.md`);
+    const [soul, bootstrap, identity, user, memoryIndex, todayMemory, yesterdayMemory] = await Promise.all([
+        readContextFile(soulPath),
+        readContextFile(bootstrapPath),
+        readContextFile(identityPath),
+        readContextFile(userPath),
+        readContextFile(memoryIndexPath),
+        readContextFile(todayMemoryPath),
+        readContextFile(yesterdayMemoryPath),
+    ]);
+    return {
+        workspacePath: resolvedWorkspace,
+        soul,
+        bootstrap,
+        identity,
+        user,
+        memoryIndex,
+        todayMemory,
+        yesterdayMemory,
+        onboardingRequired: !hasIdentityProfile(identity.content),
+    };
+}
+export function resolveWorkspacePath(workspacePath) {
+    if (workspacePath.startsWith('~')) {
+        return path.join(os.homedir(), workspacePath.slice(1));
+    }
+    return workspacePath;
+}
+function formatDateLocal(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+async function writeFileIfMissing(filePath, content) {
+    try {
+        await fs.access(filePath);
+        return false;
+    }
+    catch {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, content, 'utf8');
+        return true;
+    }
+}
+async function readContextFile(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, 'utf8');
+        if (raw.length <= FILE_PROMPT_LIMIT) {
+            return {
+                path: filePath,
+                exists: true,
+                content: raw,
+                truncated: false,
+            };
+        }
+        return {
+            path: filePath,
+            exists: true,
+            content: `${raw.slice(0, FILE_PROMPT_LIMIT)}\n[truncated]`,
+            truncated: true,
+        };
+    }
+    catch (error) {
+        if (isENOENT(error)) {
+            return {
+                path: filePath,
+                exists: false,
+                content: null,
+                truncated: false,
+            };
+        }
+        throw error;
+    }
+}
+function hasIdentityProfile(content) {
+    if (!content) {
+        return false;
+    }
+    const lines = content
+        .split(/\r?\n/g)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (lines.length === 0) {
+        return false;
+    }
+    const keyPrefixes = ['name:', 'creature:', 'vibe:', 'signature emoji:'];
+    const hasFilledProfileField = keyPrefixes.some((prefix) => {
+        const line = lines.find((entry) => entry.toLowerCase().startsWith(prefix));
+        if (!line) {
+            return false;
+        }
+        return line.slice(prefix.length).trim().length > 0;
+    });
+    return hasFilledProfileField || content.trim().length >= 40;
+}
+function isENOENT(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+//# sourceMappingURL=agentWorkspace.js.map

package/dist/workspace/agentWorkspace.js.map

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