@cjhyy/code-shell 0.2.0 → 0.5.0-rc.1

package/dist/run/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * Run module — managed agent run lifecycle.
- */
-export type { RunStatus, RunSnapshot, RunEventType, RunEvent, RunCheckpoint, ApprovalStatus, ApprovalCategory, RunApproval, ArtifactKind, ArtifactRole, RunArtifactRef, SubmitRunInput, ResumeRunInput, ListRunsQuery, RunExecutionContext, RunExecutionResult, RunStreamEvent, RunStreamCallback, DetachFn, } from "./types.js";
-export { VALID_TRANSITIONS } from "./types.js";
-export type { RunStore } from "./RunStore.js";
-export { FileRunStore } from "./FileRunStore.js";
-export { RunQueue } from "./RunQueue.js";
-export { RunApprovalBackend, createRunAskUserFn, type RunLifecycleHooks, type PendingApproval, type PendingInput, } from "./RunApprovalBackend.js";
-export { CheckpointWriter, type CheckpointWriterConfig } from "./CheckpointWriter.js";
-export { ArtifactTracker, type ArtifactTrackerConfig } from "./ArtifactTracker.js";
-export { RunLock, type RunLockConfig } from "./RunLock.js";
-export { Heartbeat, type HeartbeatConfig, type HeartbeatData } from "./Heartbeat.js";
-export { NoopEvaluator, CompositeEvaluator, type Evaluator, type EvaluatorResult, type EvaluatorVerdict, type EvaluatorContext, } from "./Evaluator.js";
-export { EngineRunner, type EngineRunnerConfig, type RunExecutionHandle, type RunExecutor, type CustomToolEntry, } from "./EngineRunner.js";
-export { RunManager, type RunManagerConfig } from "./RunManager.js";
-export { createRunManager, type CreateRunManagerOptions } from "./factory.js";

package/dist/run/index.js

@@ -1 +0,0 @@
-export{a as createRunManager}from'../chunk-EU3J7TBP.js';export{$ as ArtifactTracker,_ as CheckpointWriter,da as CompositeEvaluator,ea as EngineRunner,W as FileRunStore,ba as Heartbeat,ca as NoopEvaluator,Y as RunApprovalBackend,aa as RunLock,fa as RunManager,X as RunQueue,V as VALID_TRANSITIONS,Z as createRunAskUserFn}from'../chunk-MGP35GKD.js';import'../chunk-MLCTC53I.js';import'../chunk-WI6FSWGU.js';import'../chunk-P6JSTIFM.js';import'../chunk-SNFAPSLA.js';import'../chunk-L7B2ORID.js';import'../chunk-M7VU4YVY.js';import'../chunk-T222K6IV.js';import'../chunk-QTWU7UNA.js';import'../chunk-DTPABBSV.js';import'../chunk-RERBX75D.js';import'../chunk-2GJ7H5NC.js';import'../chunk-A4M2Y42L.js';import'../chunk-FU7AHZNN.js';import'../chunk-ZSAONDT6.js';import'../chunk-3QP5BQ3L.js';

package/dist/run/types.d.ts

@@ -1,136 +0,0 @@
-/**
- * Run — managed lifecycle types for long-running agent tasks.
- *
- * A Run wraps one or more Engine executions with queue, state machine,
- * checkpoint, approval, and artifact tracking.
- */
-import type { AgentPresetName } from "../preset/index.js";
-export type RunStatus = "queued" | "running" | "waiting_input" | "waiting_approval" | "blocked" | "completed" | "failed" | "cancelled";
-export interface RunSnapshot {
-    runId: string;
-    objective: string;
-    preset: AgentPresetName;
-    cwd: string;
-    status: RunStatus;
-    createdAt: number;
-    updatedAt: number;
-    startedAt: number | null;
-    finishedAt: number | null;
-    parentRunId: string | null;
-    sessionId: string | null;
-    childSessionIds: string[];
-    attemptCount: number;
-    latestCheckpointId: string | null;
-    latestApprovalId: string | null;
-    summary: string | null;
-    error: string | null;
-    tags: string[];
-    metadata: Record<string, unknown>;
-}
-export type RunEventType = "run_created" | "run_queued" | "run_started" | "session_linked" | "checkpoint_written" | "artifact_recorded" | "approval_requested" | "approval_resolved" | "run_blocked" | "run_resumed" | "run_completed" | "run_failed" | "run_cancelled";
-export interface RunEvent {
-    eventId: string;
-    runId: string;
-    type: RunEventType;
-    timestamp: number;
-    data: Record<string, unknown>;
-}
-export interface RunCheckpoint {
-    checkpointId: string;
-    runId: string;
-    createdAt: number;
-    phase: string;
-    objective: string;
-    summary: string;
-    nextAction: string | null;
-    linkedSessionId: string | null;
-    touchedTools: string[];
-    touchedArtifacts: string[];
-    waitingFor: null | {
-        kind: "input";
-        prompt: string;
-    } | {
-        kind: "approval";
-        approvalId: string;
-    };
-    evaluator: null | {
-        status: "pending" | "passed" | "failed";
-        findings: string[];
-    };
-    metadata: Record<string, unknown>;
-}
-export type ApprovalStatus = "pending" | "approved" | "rejected";
-export type ApprovalCategory = "tool" | "artifact_publish" | "workflow_transition" | "custom";
-export interface RunApproval {
-    approvalId: string;
-    runId: string;
-    createdAt: number;
-    resolvedAt: number | null;
-    status: ApprovalStatus;
-    category: ApprovalCategory;
-    title: string;
-    description: string;
-    payload: Record<string, unknown>;
-}
-export type ArtifactKind = "file" | "document" | "diagram" | "prototype" | "resource" | "custom";
-export type ArtifactRole = "input" | "output" | "checkpoint" | "supporting";
-export interface RunArtifactRef {
-    artifactRefId: string;
-    runId: string;
-    kind: ArtifactKind;
-    title: string;
-    locator: string;
-    role: ArtifactRole;
-    version: string | null;
-    metadata: Record<string, unknown>;
-}
-export interface SubmitRunInput {
-    objective: string;
-    preset?: AgentPresetName;
-    cwd?: string;
-    parentRunId?: string;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-}
-export interface ResumeRunInput {
-    userInput?: string;
-    approvalDecision?: {
-        approvalId: string;
-        approved: boolean;
-        reason?: string;
-    };
-}
-export interface ListRunsQuery {
-    status?: RunStatus | RunStatus[];
-    tag?: string;
-    limit?: number;
-    offset?: number;
-}
-export interface RunExecutionContext {
-    onStream?: import("../types.js").StreamCallback;
-    signal?: AbortSignal;
-    engineConfigOverrides?: Record<string, unknown>;
-}
-export interface RunExecutionResult {
-    text: string;
-    reason: import("../types.js").TerminalReason;
-    sessionId: string;
-    turnCount: number;
-}
-export type RunStreamEvent = {
-    type: "run_status_changed";
-    run: RunSnapshot;
-} | {
-    type: "run_event";
-    event: RunEvent;
-} | {
-    type: "engine_stream";
-    event: import("../types.js").StreamEvent;
-};
-export type RunStreamCallback = (event: RunStreamEvent) => void | Promise<void>;
-export type DetachFn = () => void;
-/**
- * Valid state transitions for a Run.
- * Key = current status, Value = allowed next statuses.
- */
-export declare const VALID_TRANSITIONS: Record<RunStatus, RunStatus[]>;

package/dist/seatbelt-L54CNI2Y.js

@@ -1,37 +0,0 @@
-import {h,a}from'./chunk-3QP5BQ3L.js';import {mkdtempSync,writeFileSync,rmSync}from'fs';import {tmpdir}from'os';import {join}from'path';h();function y(e){return {name:"seatbelt",wrap(o,l){let n=b(e),t=mkdtempSync(join(tmpdir(),"codeshell-sandbox-")),a$1=join(t,"profile.sb");return writeFileSync(a$1,n,"utf-8"),{file:"/usr/bin/sandbox-exec",args:["-f",a$1,l.shell,"-c",o],cleanup:a(()=>{try{rmSync(t,{recursive:!0,force:!0});}catch{}},"cleanup")}},hintForBlockedOutput(o){if(/Operation not permitted|sandbox/.test(o))return `
-[sandbox:seatbelt] A syscall was blocked by the sandbox. If this path should be writable or this network call legitimate, ask the user to update sandbox.writableRoots / sandbox.network in settings.json.`}}}a(y,"createSeatbeltBackend");function b(e){let o=e.writableRoots.map(t=>`  (subpath ${d(t)})`).join(`
-`),l=e.deniedReads.map(t=>`  (subpath ${d(t)})`).join(`
-`),n=e.network==="deny"?"(deny network-outbound)":"(allow network*)";return `(version 1)
-(deny default)
-
-;; Process control
-(allow process-fork)
-(allow process-exec)
-(allow signal (target self))
-(allow signal (target children))
-
-;; Reads: broadly allowed, then explicit deny of sensitive paths
-(allow file-read*)
-${l?`(deny file-read*
-${l})`:""}
-
-;; Writes: workspace + listed roots only
-(allow file-write*
-${o})
-(allow file-write-data
-  (literal "/dev/null")
-  (literal "/dev/zero")
-  (literal "/dev/random")
-  (literal "/dev/urandom")
-  (literal "/dev/dtracehelper"))
-
-;; IPC & system services common tools need
-(allow mach-lookup)
-(allow ipc-posix-shm)
-(allow sysctl-read)
-(allow system-socket)
-(allow iokit-open)
-
-;; Network
-${n}
-`}a(b,"buildProfile");function d(e){return `"${e.replace(/"/g,'\\"')}"`}a(d,"quote");export{y as createSeatbeltBackend};

package/dist/services/analytics.d.ts

@@ -1,29 +0,0 @@
-/**
- * Analytics service — event tracking and telemetry.
- *
- * Provides a lightweight analytics pipeline that queues events
- * and flushes them to configured sinks (file, console, or remote).
- */
-export interface AnalyticsEvent {
-    name: string;
-    properties?: Record<string, unknown>;
-    timestamp?: string;
-}
-type AnalyticsSink = (events: AnalyticsEvent[]) => void;
-declare class AnalyticsService {
-    private queue;
-    private sinks;
-    private flushTimer;
-    private initialized;
-    /**
-     * Initialize the analytics service with default file sink.
-     */
-    init(): void;
-    addSink(sink: AnalyticsSink): void;
-    track(name: string, properties?: Record<string, unknown>): void;
-    flush(): void;
-    shutdown(): void;
-}
-export declare const analytics: AnalyticsService;
-export declare function trackEvent(name: string, properties?: Record<string, unknown>): void;
-export {};

package/dist/services/auto-dream.d.ts

@@ -1,35 +0,0 @@
-/**
- * AutoDream service — background memory consolidation.
- *
- * Periodically consolidates and organizes memories using the LLM,
- * similar to the /dream command but running automatically.
- */
-export interface AutoDreamConfig {
-    /** Minimum sessions between dream runs */
-    minSessionsBetween: number;
-    /** Minimum time between dream runs (ms) */
-    minTimeBetween: number;
-    /** Whether auto-dream is enabled */
-    enabled: boolean;
-}
-/**
- * Check if auto-dream should run.
- */
-export declare function shouldAutoDream(config?: AutoDreamConfig): boolean;
-/**
- * Record that a session was completed (increment counter).
- */
-export declare function recordSession(): void;
-/**
- * Record that a dream run completed.
- */
-export declare function recordDreamComplete(): void;
-/**
- * Build the consolidation prompt for auto-dream.
- */
-export declare function buildDreamPrompt(memories: Array<{
-    name: string;
-    type: string;
-    description: string;
-    content: string;
-}>): string;

package/dist/services/diagnostics.d.ts

@@ -1,41 +0,0 @@
-/**
- * Diagnostics service — error tracking and system health monitoring.
- *
- * Collects and reports diagnostic information for debugging.
- */
-export interface DiagnosticEntry {
-    timestamp: string;
-    level: "error" | "warn" | "info";
-    category: string;
-    message: string;
-    metadata?: Record<string, unknown>;
-    stack?: string;
-}
-declare class DiagnosticsTracker {
-    private logDir;
-    private entries;
-    constructor();
-    /**
-     * Record a diagnostic event.
-     */
-    record(level: DiagnosticEntry["level"], category: string, message: string, metadata?: Record<string, unknown>): void;
-    /**
-     * Record an error with stack trace.
-     */
-    recordError(category: string, error: Error, metadata?: Record<string, unknown>): void;
-    /**
-     * Get recent diagnostic entries.
-     */
-    getRecent(count?: number): DiagnosticEntry[];
-    /**
-     * Get entries by category.
-     */
-    getByCategory(category: string): DiagnosticEntry[];
-    /**
-     * Generate a diagnostic report for troubleshooting.
-     */
-    generateReport(): string;
-    private persist;
-}
-export declare const diagnostics: DiagnosticsTracker;
-export {};

package/dist/services/extract-memories.d.ts

@@ -1,27 +0,0 @@
-/**
- * Extract Memories service — extract durable memories from session transcripts.
- *
- * Runs at the end of a query loop to identify important information
- * worth persisting across sessions.
- */
-export interface ExtractedMemory {
-    type: "user" | "feedback" | "project" | "reference";
-    name: string;
-    description: string;
-    content: string;
-}
-/**
- * Build the prompt for extracting memories from a conversation.
- */
-export declare function buildExtractionPrompt(transcript: Array<{
-    role: string;
-    content: string;
-}>, existingMemories: Array<{
-    name: string;
-    type: string;
-    description: string;
-}>): string;
-/**
- * Parse extracted memories from LLM response.
- */
-export declare function parseExtractionResponse(response: string): ExtractedMemory[];

package/dist/services/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Services index — re-exports all service modules.
- */
-export { analytics, trackEvent } from "./analytics.js";
-export { authorize, refreshToken, type OAuthConfig, type OAuthTokens } from "./oauth.js";
-export { notify, notifyComplete, notifyError } from "./notifier.js";
-export { diagnostics } from "./diagnostics.js";
-export { buildExtractionPrompt, parseExtractionResponse, type ExtractedMemory, } from "./extract-memories.js";
-export { shouldAutoDream, recordSession, recordDreamComplete, buildDreamPrompt, } from "./auto-dream.js";
-export { saveSessionMemory, loadSessionMemory, listSessionMemories, searchSessionMemories, buildSessionMemoryPrompt, } from "./session-memory.js";

package/dist/services/notifier.d.ts

@@ -1,25 +0,0 @@
-/**
- * Notifier service — desktop/system notifications.
- *
- * Sends notifications when tasks complete, agents finish, or errors occur.
- * Falls back gracefully when no notification system is available.
- */
-export interface NotificationOptions {
-    title: string;
-    message: string;
-    sound?: boolean;
-    /** Urgency level: low, normal, critical */
-    urgency?: "low" | "normal" | "critical";
-}
-/**
- * Send a desktop notification.
- */
-export declare function notify(options: NotificationOptions): void;
-/**
- * Send a notification that a task/agent has completed.
- */
-export declare function notifyComplete(taskName: string, duration?: number): void;
-/**
- * Send an error notification.
- */
-export declare function notifyError(context: string, error: string): void;

package/dist/services/oauth.d.ts

@@ -1,27 +0,0 @@
-/**
- * OAuth service — OAuth 2.0 authorization code flow with PKCE.
- *
- * Supports browser-based login flow for API authentication.
- */
-export interface OAuthConfig {
-    clientId: string;
-    authorizationEndpoint: string;
-    tokenEndpoint: string;
-    redirectUri?: string;
-    scopes?: string[];
-}
-export interface OAuthTokens {
-    accessToken: string;
-    refreshToken?: string;
-    expiresAt?: number;
-    tokenType: string;
-}
-/**
- * Run the OAuth authorization code flow.
- * Opens a browser for user login and waits for the callback.
- */
-export declare function authorize(config: OAuthConfig): Promise<OAuthTokens>;
-/**
- * Refresh an access token using a refresh token.
- */
-export declare function refreshToken(config: OAuthConfig, refreshTokenValue: string): Promise<OAuthTokens>;

package/dist/services/session-memory.d.ts

@@ -1,37 +0,0 @@
-/**
- * Session Memory service — automatic session memory maintenance.
- *
- * Extracts and maintains conversation context as persistent memory
- * entries that survive across sessions.
- */
-export interface SessionMemoryEntry {
-    sessionId: string;
-    summary: string;
-    keyTopics: string[];
-    decisions: string[];
-    createdAt: string;
-    tokenCount?: number;
-}
-/**
- * Save a session memory entry.
- */
-export declare function saveSessionMemory(entry: SessionMemoryEntry): void;
-/**
- * Load a session memory by session ID.
- */
-export declare function loadSessionMemory(sessionId: string): SessionMemoryEntry | null;
-/**
- * List all session memories, most recent first.
- */
-export declare function listSessionMemories(limit?: number): SessionMemoryEntry[];
-/**
- * Search session memories by keyword.
- */
-export declare function searchSessionMemories(query: string): SessionMemoryEntry[];
-/**
- * Build a prompt for extracting session memory from a conversation.
- */
-export declare function buildSessionMemoryPrompt(messages: Array<{
-    role: string;
-    content: string;
-}>): string;

package/dist/session/file-history.d.ts

@@ -1,41 +0,0 @@
-/**
- * File history — automatic backup of files before modifications.
- *
- * Stores snapshots in the session directory under file-history/.
- * Supports restoring files to a previous state.
- */
-export interface FileSnapshot {
-    filePath: string;
-    timestamp: number;
-    backupPath: string;
-    hash: string;
-    size: number;
-}
-export declare class FileHistory {
-    private readonly historyDir;
-    private snapshots;
-    constructor(sessionDir: string);
-    /**
-     * Save a snapshot of a file before it is modified.
-     * Returns the snapshot record, or null if the file doesn't exist.
-     */
-    saveSnapshot(filePath: string): FileSnapshot | null;
-    /**
-     * Get all snapshots for a specific file.
-     */
-    getSnapshots(filePath: string): FileSnapshot[];
-    /**
-     * Restore a file to a specific snapshot.
-     */
-    restore(snapshot: FileSnapshot): boolean;
-    /**
-     * Restore a file to its most recent snapshot.
-     */
-    restoreLatest(filePath: string): boolean;
-    /**
-     * Get all tracked files.
-     */
-    getTrackedFiles(): string[];
-    private saveIndex;
-    static loadFromDir(sessionDir: string): FileHistory;
-}

package/dist/session/memory.d.ts

@@ -1,65 +0,0 @@
-/**
- * Memory system — persistent cross-session memory.
- *
- * Stores structured memory entries as individual markdown files under a base
- * directory. Resolution order for the base directory:
- *   1. explicit `baseDir` constructor arg
- *   2. CODE_SHELL_HOME env var
- *   3. ~/.code-shell
- *
- * MEMORY.md is the index file.
- */
-export interface MemoryEntry {
-    name: string;
-    description: string;
-    type: "user" | "feedback" | "project" | "reference";
-    content: string;
-    fileName: string;
-}
-export interface MemoryManagerOptions {
-    /** Project root path; when set, memories are scoped under projects/<hash>/memory. */
-    projectDir?: string;
-    /** Override the base directory (~/.code-shell by default). Takes precedence over env. */
-    baseDir?: string;
-}
-export declare function resolveMemoryBaseDir(override?: string): string;
-export declare class MemoryManager {
-    private readonly baseDir;
-    private readonly memoryDir;
-    private readonly indexPath;
-    private indexCache;
-    constructor(options?: MemoryManagerOptions | string);
-    getMemoryDir(): string;
-    /**
-     * Save a memory entry. Creates the file and updates the index.
-     */
-    save(entry: Omit<MemoryEntry, "fileName">): string;
-    /**
-     * Load all memory entries.
-     */
-    loadAll(): MemoryEntry[];
-    /**
-     * Load a single memory file.
-     */
-    private loadFile;
-    /**
-     * Delete a memory by name or filename.
-     */
-    delete(nameOrFile: string): boolean;
-    /**
-     * Get the MEMORY.md index content for injection into prompts.
-     */
-    getIndex(): string;
-    /**
-     * Build a prompt-friendly summary of all memories.
-     */
-    buildMemoryContext(): string;
-    /**
-     * Lazy-build the in-memory index from disk on first use, then
-     * keep it in sync incrementally via save/delete. Avoids the
-     * O(N²) re-read of every memory file on every save.
-     */
-    private ensureIndexCache;
-    private writeIndex;
-    private slugify;
-}

package/dist/session/session-manager.d.ts

@@ -1,28 +0,0 @@
-/**
- * Session lifecycle manager.
- */
-import type { SessionState } from "../types.js";
-import { Transcript } from "./transcript.js";
-export interface SessionBundle {
-    state: SessionState;
-    transcript: Transcript;
-}
-export declare class SessionManager {
-    private readonly sessionsDir;
-    constructor(storageDir?: string);
-    create(cwd: string, model: string, provider: string): SessionBundle;
-    resume(sessionId: string): SessionBundle;
-    saveState(state: SessionState): void;
-    /**
-     * Fork a session from a specific point.
-     * Creates a new session that shares events up to the given turn,
-     * then diverges independently.
-     */
-    fork(sourceSessionId: string, forkAtTurn?: number): SessionBundle;
-    list(limit?: number): SessionListEntry[];
-}
-export type SessionListEntry = SessionState & {
-    preview?: string;
-    /** Last activity time — transcript mtime, falling back to startedAt. */
-    lastActiveAt: number;
-};

package/dist/session/transcript.d.ts

@@ -1,39 +0,0 @@
-/**
- * Transcript — JSONL event log (NOT chat history).
- * toMessages() derives Message[] from events for sending to LLM.
- */
-import type { TranscriptEvent, TranscriptEventType, Message, ContentBlock } from "../types.js";
-export declare class Transcript {
-    private events;
-    private filePath;
-    private currentTurn;
-    getFilePath(): string;
-    constructor(filePath: string);
-    append(type: TranscriptEventType, data: Record<string, unknown>): TranscriptEvent;
-    appendMessage(role: string, content: string | ContentBlock[]): TranscriptEvent;
-    appendToolUse(toolName: string, toolCallId: string, args: Record<string, unknown>): TranscriptEvent;
-    appendToolResult(toolCallId: string, toolName: string, result?: string, error?: string): TranscriptEvent;
-    appendTurnBoundary(): TranscriptEvent;
-    appendSummary(summary: string, compactedRange: {
-        fromTurn: number;
-        toTurn: number;
-        eventCount: number;
-    }): TranscriptEvent;
-    appendError(error: string, details?: Record<string, unknown>): TranscriptEvent;
-    /**
-     * Derive Message[] from transcript events for sending to the LLM.
-     * This is the critical boundary: the LLM never sees the event log directly.
-     */
-    toMessages(): Message[];
-    getEvents(type?: TranscriptEventType): TranscriptEvent[];
-    get turnNumber(): number;
-    get eventCount(): number;
-    private flush;
-    /**
-     * Repair tool_result pairing issues:
-     * - Orphaned tool_results (no matching tool_use) get removed
-     * - Missing tool_results (tool_use with no result) get synthetic error results
-     */
-    repairToolResultPairs(): void;
-    static loadFromFile(filePath: string): Transcript;
-}

package/dist/session-manager-AGWS5SMJ.js

@@ -1 +0,0 @@
-export{b as SessionManager}from'./chunk-QTWU7UNA.js';import'./chunk-FU7AHZNN.js';import'./chunk-3QP5BQ3L.js';

package/dist/settings/manager.d.ts

@@ -1,36 +0,0 @@
-/**
- * Settings manager — multi-source loading and merge.
- *
- * Priority: CLI flags > local > project > user > managed
- */
-import { type ValidatedSettings } from "./schema.js";
-export type SettingsSourceName = "managed" | "user" | "project" | "local" | "flag";
-export declare class SettingsManager {
-    private readonly cwd;
-    private sources;
-    private merged;
-    constructor(cwd?: string);
-    /**
-     * Load settings from all sources.
-     */
-    load(flagOverrides?: Record<string, unknown>): ValidatedSettings;
-    /**
-     * Get current effective settings.
-     */
-    get(): ValidatedSettings;
-    /**
-     * Invalidate cached merge.
-     */
-    invalidate(): void;
-    /**
-     * Persist a single setting (dotted key path) to the user-level config file
-     * at ~/.code-shell/settings.json. Other sources (project / local /
-     * managed) are intentionally untouched: writing back to project/local
-     * would surprise version control, and managed is read-only.
-     *
-     * The merged cache is invalidated so the next get() picks up the change.
-     */
-    saveUserSetting(key: string, value: unknown): void;
-    private loadJsonFile;
-    private deepMerge;
-}