@earendil-works/pi-agent-core 0.83.0 → 0.84.0

package/dist/harness/types.d.ts

@@ -1,7 +1,6 @@
-import type { ImageContent, Model, Models, RetryPolicy, SimpleStreamOptions, TextContent, Transport, Usage } from "@earendil-works/pi-ai";
+import type { SimpleStreamOptions, Transport } from "@earendil-works/pi-ai";
 import type { Static, TSchema } from "typebox";
-import type { AgentEvent, AgentMessage, AgentTool, AgentToolResult, AgentToolUpdateCallback, QueueMode, ThinkingLevel } from "../index.ts";
-import type { Session } from "./session/session.ts";
+import type { AgentTool, AgentToolResult, AgentToolUpdateCallback } from "../types.ts";
 /** Result of a fallible operation. Expected failures are returned as `ok: false` instead of thrown. */
 export type Result<TValue, TError> = {
     ok: true;
@@ -106,7 +105,7 @@ export declare class ExecutionError extends Error {
     constructor(code: ExecutionErrorCode, message: string, cause?: Error);
 }
 /** Stable compaction error codes returned by compaction helpers. */
-export type CompactionErrorCode = "aborted" | "summarization_failed" | "invalid_session" | "unknown";
+export type CompactionErrorCode = "aborted" | "summarization_failed";
 /** Error returned by compaction helpers. */
 export declare class CompactionError extends Error {
     /** Backend-independent error code. */
@@ -114,26 +113,13 @@ export declare class CompactionError extends Error {
     constructor(code: CompactionErrorCode, message: string, cause?: Error);
 }
 /** Stable branch-summary error codes returned by branch summarization helpers. */
-export type BranchSummaryErrorCode = "aborted" | "summarization_failed" | "invalid_session";
+export type BranchSummaryErrorCode = "aborted" | "summarization_failed";
 /** Error returned by branch summarization helpers. */
 export declare class BranchSummaryError extends Error {
     /** Backend-independent error code. */
     code: BranchSummaryErrorCode;
     constructor(code: BranchSummaryErrorCode, message: string, cause?: Error);
 }
-export type SessionErrorCode = "not_found" | "invalid_session" | "invalid_entry" | "invalid_fork_target" | "storage" | "unknown";
-/** Error thrown by session storage, repositories, and session tree operations. */
-export declare class SessionError extends Error {
-    /** Session subsystem error code. */
-    code: SessionErrorCode;
-    constructor(code: SessionErrorCode, message: string, cause?: Error);
-}
-export type AgentHarnessErrorCode = "busy" | "invalid_state" | "invalid_argument" | "session" | "hook" | "auth" | "compaction" | "branch_summary" | "unknown";
-/** Public AgentHarness failure with a stable top-level classification. */
-export declare class AgentHarnessError extends Error {
-    code: AgentHarnessErrorCode;
-    constructor(code: AgentHarnessErrorCode, message: string, cause?: Error);
-}
 /** Metadata for one filesystem object in a {@link FileSystem}. */
 export interface FileInfo {
     /** Basename of {@link path}. */
@@ -176,6 +162,8 @@ export interface FileSystem {
     writeFile(path: string, content: string | Uint8Array, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
     /** Create or append to a file, creating parent directories when supported. */
     appendFile(path: string, content: string | Uint8Array, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
+    /** Atomically rename a file, replacing the destination when it exists. Does not copy across filesystems. */
+    renameFile(sourcePath: string, destinationPath: string, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
     /** Return metadata for the addressed path without following symlinks. */
     fileInfo(path: string, abortSignal?: AbortSignal): Promise<Result<FileInfo, FileError>>;
     /** List direct children of a directory without following symlinks. */
@@ -237,445 +225,4 @@ export interface Shell {
 /** Filesystem and process execution environment used by the harness. */
 export interface ExecutionEnv extends FileSystem, Shell {
 }
-export interface SessionTreeEntryBase {
-    type: string;
-    id: string;
-    parentId: string | null;
-    timestamp: string;
-}
-export interface MessageEntry extends SessionTreeEntryBase {
-    type: "message";
-    message: AgentMessage;
-}
-export interface ThinkingLevelChangeEntry extends SessionTreeEntryBase {
-    type: "thinking_level_change";
-    thinkingLevel: string;
-}
-export interface ModelChangeEntry extends SessionTreeEntryBase {
-    type: "model_change";
-    provider: string;
-    modelId: string;
-}
-export interface ActiveToolsChangeEntry extends SessionTreeEntryBase {
-    type: "active_tools_change";
-    activeToolNames: string[];
-}
-export interface CompactionEntry<T = unknown> extends SessionTreeEntryBase {
-    type: "compaction";
-    summary: string;
-    firstKeptEntryId?: string;
-    tokensBefore: number;
-    retainedTail?: AgentMessage[];
-    details?: T;
-    usage?: Usage;
-    fromHook?: boolean;
-}
-export interface BranchSummaryEntry<T = unknown> extends SessionTreeEntryBase {
-    type: "branch_summary";
-    fromId: string;
-    summary: string;
-    details?: T;
-    usage?: Usage;
-    fromHook?: boolean;
-}
-export interface CustomEntry<T = unknown> extends SessionTreeEntryBase {
-    type: "custom";
-    customType: string;
-    data?: T;
-}
-export interface CustomMessageEntry<T = unknown> extends SessionTreeEntryBase {
-    type: "custom_message";
-    customType: string;
-    content: string | (TextContent | ImageContent)[];
-    details?: T;
-    display: boolean;
-}
-export interface LabelEntry extends SessionTreeEntryBase {
-    type: "label";
-    targetId: string;
-    label: string | undefined;
-}
-export interface SessionInfoEntry extends SessionTreeEntryBase {
-    type: "session_info";
-    name?: string;
-}
-export interface LeafEntry extends SessionTreeEntryBase {
-    type: "leaf";
-    targetId: string | null;
-}
-export type SessionTreeEntry = MessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ActiveToolsChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | SessionInfoEntry | LeafEntry;
-export interface SessionContext {
-    messages: AgentMessage[];
-    thinkingLevel: string;
-    model: {
-        provider: string;
-        modelId: string;
-    } | null;
-    activeToolNames: string[] | null;
-}
-export interface SessionStats {
-    messageCount: number;
-    cachedTokens: number;
-    uncachedTokens: number;
-    totalTokens: number;
-    costTotal: number;
-}
-export interface SessionMetadata {
-    id: string;
-    createdAt: string;
-}
-export interface JsonlSessionMetadata extends SessionMetadata {
-    cwd: string;
-    path: string;
-    parentSessionPath?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface SessionEntryCursorOptions {
-    afterEntrySeq?: number;
-    limit?: number;
-}
-export interface SessionStorage<TMetadata extends SessionMetadata = SessionMetadata> {
-    getMetadata(): Promise<TMetadata>;
-    getLeafId(): Promise<string | null>;
-    /** Persist a leaf entry that records the active session-tree leaf. */
-    setLeafId(leafId: string | null): Promise<void>;
-    createEntryId(): Promise<string>;
-    appendEntry(entry: SessionTreeEntry): Promise<void>;
-    getEntry(id: string): Promise<SessionTreeEntry | undefined>;
-    findEntries<TType extends SessionTreeEntry["type"]>(type: TType): Promise<Array<Extract<SessionTreeEntry, {
-        type: TType;
-    }>>>;
-    getLabel(id: string): Promise<string | undefined>;
-    getSessionName(): Promise<string | undefined>;
-    getSessionStats(): Promise<SessionStats>;
-    getPathToRootOrCompaction(leafId: string | null): Promise<SessionTreeEntry[]>;
-    getEntries(options?: SessionEntryCursorOptions): Promise<SessionTreeEntry[]>;
-}
-export type { Session } from "./session/session.ts";
-export interface SessionCreateOptions {
-    id?: string;
-}
-export interface SessionForkOptions {
-    entryId?: string;
-    position?: "before" | "at";
-    id?: string;
-}
-export interface SessionRepo<TMetadata extends SessionMetadata = SessionMetadata, TCreateOptions extends SessionCreateOptions = SessionCreateOptions, TListOptions = void> {
-    create(options: TCreateOptions): Promise<Session<TMetadata>>;
-    open(metadata: TMetadata): Promise<Session<TMetadata>>;
-    list(options?: TListOptions): Promise<TMetadata[]>;
-    delete(metadata: TMetadata): Promise<void>;
-    fork(source: TMetadata, options: SessionForkOptions & TCreateOptions): Promise<Session<TMetadata>>;
-}
-export interface JsonlSessionCreateOptions extends SessionCreateOptions {
-    cwd: string;
-    parentSessionPath?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface JsonlSessionListOptions {
-    cwd?: string;
-}
-export interface JsonlSessionRepoApi extends SessionRepo<JsonlSessionMetadata, JsonlSessionCreateOptions, JsonlSessionListOptions> {
-}
-export type AgentHarnessPhase = "idle" | "turn" | "compaction" | "branch_summary" | "retry";
-export type PendingSessionWrite = SessionTreeEntry extends infer TEntry ? TEntry extends SessionTreeEntry ? Omit<TEntry, "id" | "parentId" | "timestamp"> : never : never;
-export interface QueueUpdateEvent {
-    type: "queue_update";
-    steer: AgentMessage[];
-    followUp: AgentMessage[];
-    nextTurn: AgentMessage[];
-}
-export interface SavePointEvent {
-    type: "save_point";
-    hadPendingMutations: boolean;
-}
-export interface AbortEvent {
-    type: "abort";
-    clearedSteer: AgentMessage[];
-    clearedFollowUp: AgentMessage[];
-}
-export interface SettledEvent {
-    type: "settled";
-    nextTurnCount: number;
-}
-export interface BeforeAgentStartEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> {
-    type: "before_agent_start";
-    prompt: string;
-    images?: ImageContent[];
-    systemPrompt: string;
-    resources: AgentHarnessResources<TSkill, TPromptTemplate>;
-}
-export interface ContextEvent {
-    type: "context";
-    messages: AgentMessage[];
-}
-export interface BeforeProviderRequestEvent {
-    type: "before_provider_request";
-    model: Model<any>;
-    sessionId: string;
-    streamOptions: AgentHarnessStreamOptions;
-}
-export interface BeforeProviderPayloadEvent {
-    type: "before_provider_payload";
-    model: Model<any>;
-    payload: unknown;
-}
-export interface AfterProviderResponseEvent {
-    type: "after_provider_response";
-    status: number;
-    headers: Record<string, string>;
-}
-export interface ToolCallEvent {
-    type: "tool_call";
-    toolCallId: string;
-    toolName: string;
-    input: Record<string, unknown>;
-}
-export interface ToolResultEvent {
-    type: "tool_result";
-    toolCallId: string;
-    toolName: string;
-    input: Record<string, unknown>;
-    content: Array<TextContent | ImageContent>;
-    details: unknown;
-    isError: boolean;
-    usage?: Usage;
-}
-export interface SessionBeforeCompactEvent {
-    type: "session_before_compact";
-    preparation: CompactionPreparation;
-    branchEntries: SessionTreeEntry[];
-    customInstructions?: string;
-    signal: AbortSignal;
-}
-export interface SessionCompactEvent {
-    type: "session_compact";
-    compactionEntry: CompactionEntry;
-    fromHook: boolean;
-}
-export interface SessionBeforeTreeEvent {
-    type: "session_before_tree";
-    preparation: TreePreparation;
-    signal: AbortSignal;
-}
-export interface SessionTreeEvent {
-    type: "session_tree";
-    newLeafId: string | null;
-    oldLeafId: string | null;
-    summaryEntry?: BranchSummaryEntry;
-    fromHook?: boolean;
-}
-export interface RetryScheduledEvent {
-    type: "retry_scheduled";
-    operation: "compaction" | "branch_summary";
-    attempt: number;
-    maxAttempts: number;
-    delayMs: number;
-    errorMessage: string;
-}
-export interface RetryAttemptStartEvent {
-    type: "retry_attempt_start";
-    operation: "compaction" | "branch_summary";
-}
-export interface RetryFinishedEvent {
-    type: "retry_finished";
-    operation: "compaction" | "branch_summary";
-}
-export interface ModelUpdateEvent {
-    type: "model_update";
-    model: Model<any>;
-    previousModel: Model<any> | undefined;
-    source: "set" | "restore";
-}
-export interface ThinkingLevelUpdateEvent {
-    type: "thinking_level_update";
-    level: ThinkingLevel;
-    previousLevel: ThinkingLevel;
-}
-export interface ToolsUpdateEvent {
-    type: "tools_update";
-    toolNames: string[];
-    previousToolNames: string[];
-    activeToolNames: string[];
-    previousActiveToolNames: string[];
-    source: "set" | "restore";
-}
-export interface ResourcesUpdateEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> {
-    type: "resources_update";
-    resources: AgentHarnessResources<TSkill, TPromptTemplate>;
-    previousResources: AgentHarnessResources<TSkill, TPromptTemplate>;
-}
-export type AgentHarnessOwnEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> = QueueUpdateEvent | SavePointEvent | AbortEvent | SettledEvent | BeforeAgentStartEvent<TSkill, TPromptTemplate> | ContextEvent | BeforeProviderRequestEvent | BeforeProviderPayloadEvent | AfterProviderResponseEvent | ToolCallEvent | ToolResultEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionBeforeTreeEvent | SessionTreeEvent | RetryScheduledEvent | RetryAttemptStartEvent | RetryFinishedEvent | ModelUpdateEvent | ThinkingLevelUpdateEvent | ResourcesUpdateEvent<TSkill, TPromptTemplate> | ToolsUpdateEvent;
-export type AgentHarnessEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> = AgentEvent | AgentHarnessOwnEvent<TSkill, TPromptTemplate>;
-export interface BeforeAgentStartResult {
-    messages?: AgentMessage[];
-    systemPrompt?: string;
-}
-export interface ContextResult {
-    messages: AgentMessage[];
-}
-export interface BeforeProviderRequestResult {
-    streamOptions?: AgentHarnessStreamOptionsPatch;
-}
-export interface BeforeProviderPayloadResult {
-    payload: unknown;
-}
-export interface ToolCallResult {
-    block?: boolean;
-    reason?: string;
-}
-export interface ToolResultPatch {
-    content?: Array<TextContent | ImageContent>;
-    details?: unknown;
-    isError?: boolean;
-    usage?: Usage;
-    terminate?: boolean;
-}
-export interface SessionBeforeCompactResult {
-    cancel?: boolean;
-    compaction?: CompactResult;
-}
-export interface SessionBeforeTreeResult {
-    cancel?: boolean;
-    summary?: {
-        summary: string;
-        details?: unknown;
-        /** Usage from the LLM call that generated this summary, if available. */
-        usage?: Usage;
-    };
-    customInstructions?: string;
-    replaceInstructions?: boolean;
-    label?: string;
-}
-export type AgentHarnessEventResultMap = {
-    before_agent_start: BeforeAgentStartResult | undefined;
-    context: ContextResult | undefined;
-    before_provider_request: BeforeProviderRequestResult | undefined;
-    before_provider_payload: BeforeProviderPayloadResult | undefined;
-    after_provider_response: undefined;
-    tool_call: ToolCallResult | undefined;
-    tool_result: ToolResultPatch | undefined;
-    session_before_compact: SessionBeforeCompactResult | undefined;
-    session_compact: undefined;
-    session_before_tree: SessionBeforeTreeResult | undefined;
-    session_tree: undefined;
-    retry_scheduled: undefined;
-    retry_attempt_start: undefined;
-    retry_finished: undefined;
-    model_update: undefined;
-    thinking_level_update: undefined;
-    resources_update: undefined;
-    tools_update: undefined;
-    queue_update: undefined;
-    save_point: undefined;
-    abort: undefined;
-    settled: undefined;
-};
-export interface AgentHarnessPromptOptions {
-    images?: ImageContent[];
-}
-export interface AbortResult {
-    clearedSteer: AgentMessage[];
-    clearedFollowUp: AgentMessage[];
-}
-export interface CompactResult {
-    summary: string;
-    firstKeptEntryId?: string;
-    tokensBefore: number;
-    /** Usage from the LLM call(s) that generated this summary, if available. */
-    usage?: Usage;
-    retainedTail?: AgentMessage[];
-    details?: unknown;
-}
-export interface NavigateTreeResult {
-    cancelled: boolean;
-    editorText?: string;
-    summaryEntry?: BranchSummaryEntry;
-}
-export interface CompactionSettings {
-    enabled: boolean;
-    reserveTokens: number;
-    keepRecentTokens: number;
-}
-export interface CompactionPreparation {
-    firstKeptEntryId: string;
-    messagesToSummarize: AgentMessage[];
-    turnPrefixMessages: AgentMessage[];
-    retainedTail: AgentMessage[];
-    isSplitTurn: boolean;
-    tokensBefore: number;
-    previousSummary?: string;
-    fileOps: FileOperations;
-    settings: CompactionSettings;
-}
-export interface FileOperations {
-    read: Set<string>;
-    written: Set<string>;
-    edited: Set<string>;
-}
-export interface TreePreparation {
-    targetId: string;
-    oldLeafId: string | null;
-    commonAncestorId: string | null;
-    entriesToSummarize: SessionTreeEntry[];
-    userWantsSummary: boolean;
-    customInstructions?: string;
-    replaceInstructions?: boolean;
-    label?: string;
-}
-export interface GenerateBranchSummaryOptions {
-    model: Model<any>;
-    apiKey: string;
-    headers?: Record<string, string>;
-    signal: AbortSignal;
-    customInstructions?: string;
-    replaceInstructions?: boolean;
-    reserveTokens?: number;
-}
-export interface BranchSummaryResult {
-    summary: string;
-    usage?: Usage;
-    readFiles: string[];
-    modifiedFiles: string[];
-}
-export type AgentHarnessSystemPrompt<TContext extends object | undefined = undefined, TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate, TTool extends AgentHarnessTool<TContext> = AgentHarnessTool<TContext>> = string | ((context: {
-    session: Session;
-    model: Model<any>;
-    thinkingLevel: ThinkingLevel;
-    activeTools: TTool[];
-    resources: AgentHarnessResources<TSkill, TPromptTemplate>;
-}) => string | Promise<string>);
-interface AgentHarnessOptionsBase<TContext extends object | undefined, TSkill extends Skill, TPromptTemplate extends PromptTemplate, TTool extends AgentHarnessTool<TContext>> {
-    session: Session;
-    /**
-     * Provider collection used for all model requests (turn streaming,
-     * compaction, branch summarization). Auth resolves through the providers'
-     * auth.
-     */
-    models: Models;
-    tools?: TTool[];
-    /**
-     * Concrete resources available to explicit invocation methods and system-prompt callbacks.
-     * Applications own loading/reloading resources and should call `setResources()` with new values.
-     */
-    resources?: AgentHarnessResources<TSkill, TPromptTemplate>;
-    systemPrompt?: AgentHarnessSystemPrompt<TContext, TSkill, TPromptTemplate, TTool>;
-    /** Curated stream/provider request options. Snapshotted at turn start. */
-    streamOptions?: AgentHarnessStreamOptions;
-    /** Optional retry policy for generated compaction and branch-summary requests. */
-    retry?: RetryPolicy;
-    model: Model<any>;
-    thinkingLevel?: ThinkingLevel;
-    activeToolNames?: string[];
-    steeringMode?: QueueMode;
-    followUpMode?: QueueMode;
-}
-export type AgentHarnessOptions<TContext extends object | undefined = undefined, TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate, TTool extends AgentHarnessTool<TContext> = AgentHarnessTool<TContext>> = AgentHarnessOptionsBase<TContext, TSkill, TPromptTemplate, TTool> & ([TContext] extends [undefined] ? {
-    /** Context-free harnesses do not need a tool context. */
-    toolContext?: undefined;
-} : {
-    /** Static context or zero-argument context provider resolved for each turn snapshot. */
-    toolContext: AgentHarnessToolContextSource<TContext>;
-});
-export type { AgentHarness } from "./agent-harness.ts";
 //# sourceMappingURL=types.d.ts.map