skyloom 1.4.0

package/dist/core/agent.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Base agent class for all Skyloom agents.
+ *
+ * Provides the core LLM reasoning loop, tool execution, memory management,
+ * skill activation, and inter-agent communication.
+ */
+import { Event, MessageBus } from './bus';
+import { LLMClient, type LLMResponse, type ToolCall } from './llm';
+import { Memory, Message } from './memory';
+import { Skill, SkillRegistry } from './skill';
+import { type ToolDefinition, ToolRegistry } from './tool';
+export declare enum AgentState {
+    IDLE = "idle",
+    THINKING = "thinking",
+    ACTING = "acting",
+    WAITING = "waiting",
+    ERROR = "error"
+}
+export declare enum TaskState {
+    PENDING = "pending",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    SKIPPED = "skipped"
+}
+export declare class Task {
+    id: string;
+    description: string;
+    assignedTo: string | null;
+    parentId: string | null;
+    dependsOn: string[];
+    status: TaskState;
+    priority: number;
+    result: string | null;
+    metadata: Record<string, any>;
+    constructor(config: {
+        id: string;
+        description: string;
+        assignedTo?: string | null;
+        parentId?: string | null;
+        dependsOn?: string[];
+        status?: TaskState;
+        priority?: number;
+        result?: string | null;
+        metadata?: Record<string, any>;
+    });
+    transitionTo(newState: TaskState): void;
+    get allDeps(): string[];
+}
+export declare class TaskResult {
+    success: boolean;
+    content: string;
+    data: Record<string, any>;
+    constructor(success: boolean, content: string, data?: Record<string, any>);
+}
+export type { Message };
+export declare class BaseAgent {
+    name: string;
+    displayName: string;
+    emoji: string;
+    specialty: string;
+    systemPrompt: string;
+    toolNames: string[];
+    skillNames: string[];
+    protected config: any;
+    protected llm: LLMClient;
+    protected bus: MessageBus;
+    protected toolRegistry: ToolRegistry;
+    protected skillRegistry: SkillRegistry;
+    state: AgentState;
+    memory: Memory;
+    protected _tools: ToolDefinition[];
+    protected _skills: Skill[];
+    protected _activeSkills: Set<string>;
+    protected _skillTools: Map<string, string[]>;
+    protected _skillConfigOverrides: Map<string, Record<string, any>>;
+    protected _baseSystemPrompt: string;
+    protected _maxToolRounds: number;
+    protected _maxToolRoundsHardCap: number;
+    protected _userTurnsSinceExtract: number;
+    protected _pendingExtracts: Set<Promise<any>>;
+    protected _pendingRequests: Map<string, {
+        resolve: (value: string) => void;
+        reject: (err: Error) => void;
+    }>;
+    protected _bgTasks: Set<Promise<void>>;
+    approvalCallback: ((toolName: string, args: Record<string, any>) => Promise<boolean>) | null;
+    protected _turnLock: Promise<void>;
+    private _turnLockCounter;
+    private _turnLockResolve;
+    private static _timeTag;
+    private static _timeTagTs;
+    constructor(config: any, llm: LLMClient, bus: MessageBus, toolRegistry: ToolRegistry, skillRegistry?: SkillRegistry | null);
+    protected resolveSystemPrompt(): string;
+    protected injectWorkspaceInfo(prompt: string): string;
+    protected currentTimeTag(): string;
+    protected injectBehaviorRules(prompt: string): string;
+    protected injectProgrammingWisdom(prompt: string): string;
+    reinitLanguage(): void;
+    init(): Promise<void>;
+    refreshTools(): void;
+    loadSkills(): void;
+    registerSkillTools(): void;
+    activateSkill(name: string): boolean;
+    deactivateSkill(name: string): boolean;
+    deactivateAllSkills(): void;
+    protected autoActivateSkills(message: string): string[];
+    protected runtimeIdentityBlock(): string;
+    protected rebuildSystemPrompt(): void;
+    getActiveSkills(): string[];
+    getSkillConfigOverrides(): Record<string, any>;
+    getAvailableSkills(): Array<{
+        name: string;
+        description: string;
+        active: boolean;
+    }>;
+    /**
+     * Shared tool execution pipeline — parse, deduplicate, execute, record.
+     *
+     * Both chatStreamImpl (streaming) and llmLoop (batch) use the same tool
+     * execution flow. Extracting it here eliminates ~80 lines of duplicated
+     * Phase-A/B/C/D logic and ensures consistent behavior (dangerous-tool
+     * approval, dedup, error handling) across both paths.
+     *
+     * @returns Array of { tc, result, success, toolName } for each tool call
+     */
+    protected executeToolCalls(toolCalls: ToolCall[], options?: {
+        dedupCacheable?: boolean;
+        onStatus?: (label: string) => void;
+        suppressedTools?: Set<string>;
+        ephemeral?: boolean;
+    }): Promise<Array<{
+        tc: ToolCall;
+        result: string;
+        success: boolean;
+        toolName: string;
+    }>>;
+    close(): Promise<void>;
+    protected setState(newState: AgentState): Promise<void>;
+    handleEvent(event: Event): Promise<void>;
+    chatOneshot(prompt: string, options?: {
+        model?: string;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    chat(message: string, onStatus?: ((status: string) => void) | null): Promise<string>;
+    protected chatImpl(message: string, onStatus?: ((status: string) => void) | null): Promise<string>;
+    chatStream(message: string): AsyncGenerator<Record<string, any>>;
+    protected chatStreamImpl(message: string, autoActivated?: string[]): AsyncGenerator<Record<string, any>>;
+    protected popLastUserMessage(): void;
+    compact(keepRecent?: number): Promise<string>;
+    contextUsage(): Record<string, any>;
+    protected shouldAutoCompact(): boolean;
+    protected activeToolNames(): string[];
+    private readonly EXTRACT_PROMPT;
+    protected maybeExtractFacts(): void;
+    private extractFactsAsync;
+    private parseExtractedFacts;
+    protected messagesWithRecall(): Promise<Record<string, any>[]>;
+    protected llmLoop(options?: {
+        maxIterations?: number;
+        onStatus?: ((status: string) => void) | null;
+        ephemeral?: boolean;
+    }): Promise<LLMResponse>;
+    executeTask(task: Task, onStatus?: ((status: string) => void) | null): Promise<TaskResult>;
+    private executeTaskImpl;
+    protected checkToolApproval(toolName: string, toolArgs: Record<string, any>): Promise<boolean>;
+    requestHelp(targetAgent: string, description: string, timeout?: number): Promise<string>;
+    protected handleRequest(event: Event): Promise<void>;
+    protected handleResponse(event: Event): void;
+    getStatus(): Record<string, any>;
+    private withTurnLock;
+}
+//# sourceMappingURL=agent.d.ts.map

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

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