@farazirfan/costar-server-executor 1.7.29 → 1.7.31

package/dist/agent/agent.d.ts

@@ -18,6 +18,7 @@ export type AgentTurnResult = {
     turns?: number;
     inputTokens?: number;
     outputTokens?: number;
+    compactionCount?: number;
 };
 /**
  * Agent execution options
@@ -45,6 +46,27 @@ export type AgentExecutionOptions = {
         isError?: boolean;
         durationMs?: number;
     }) => void;
+    /** Called when auto-compaction starts */
+    onCompactionStart?: () => void;
+    /** Called when auto-compaction ends */
+    onCompactionEnd?: (event: {
+        willRetry?: boolean;
+        error?: string;
+    }) => void;
+};
+/**
+ * Isolated turn result — extends AgentTurnResult with delivery conflict info.
+ * Pattern: OpenClaw's RunCronAgentTurnResult (cron/isolated-agent/run.ts)
+ */
+export type IsolatedTurnResult = AgentTurnResult & {
+    /** The last non-empty text from agent payloads */
+    outputText?: string;
+    /**
+     * True when the isolated run already delivered its output via the
+     * messaging tool. Callers should skip announce to avoid duplicate messages.
+     * Pattern: OpenClaw's didSendViaMessagingTool (run.ts:579-588)
+     */
+    didSendViaMessagingTool: boolean;
 };
 /**
  * Main agent class - refactored to use pi-ai (OpenClaw style)
@@ -101,6 +123,30 @@ export declare class Agent {
      * Pattern: OpenClaw's getQueueSize > 0 check (requests-in-flight)
      */
     isBusy(): boolean;
+    /**
+     * Get the main session file path.
+     * Used by the heartbeat runner for transcript pruning (OpenClaw pattern).
+     */
+    getSessionFile(): string;
+    /**
+     * Capture the current session file size before a heartbeat run.
+     * Pattern: OpenClaw's captureTranscriptState (heartbeat-runner.ts)
+     */
+    captureTranscriptState(): {
+        transcriptPath: string;
+        preHeartbeatSize: number;
+    };
+    /**
+     * Prune the session transcript back to its pre-heartbeat size.
+     * This removes the user+assistant turns added during a HEARTBEAT_OK run
+     * so routine checks don't pollute the main session.
+     *
+     * Pattern: OpenClaw's pruneHeartbeatTranscript (heartbeat-runner.ts:387-404)
+     */
+    pruneHeartbeatTranscript(state: {
+        transcriptPath: string;
+        preHeartbeatSize: number;
+    }): void;
     /**
      * Execute a single agent turn using pi-ai
      */
@@ -115,6 +161,55 @@ export declare class Agent {
      * Pattern: OpenClaw's EXEC_EVENT_PROMPT
      */
     executeExecEventHeartbeat(options?: AgentExecutionOptions): Promise<AgentTurnResult>;
+    /**
+     * Run an agent turn in an ISOLATED session.
+     * The main session file is NOT touched.
+     *
+     * Pattern: OpenClaw's runCronIsolatedAgentTurn — creates a separate
+     * sessionId/sessionFile, runs the agent, returns the result.
+     *
+     * Session lifecycle (matches OpenClaw):
+     * - By default, the session file is KEPT after the run (deleteAfterRun=false).
+     *   This allows cron/heartbeat sessions to accumulate context across runs,
+     *   with auto-compaction managing size (OpenClaw default behavior).
+     * - Set deleteAfterRun=true to delete the session file after the run
+     *   (one-shot tasks that don't need context persistence).
+     *
+     * Ported from OpenClaw with:
+     * - Session freshness/reuse (resolveCronSession pattern)
+     * - Configurable reset policy (daily/idle, not hardcoded)
+     * - Lane isolation (lane: "cron")
+     * - Special system prompt for isolated runs (buildSubagentSystemPrompt pattern)
+     * - didSendViaMessagingTool tracking
+     * - Session store persistence
+     * - Conditional session cleanup (deleteAfterRun, OpenClaw: cleanup "delete"|"keep")
+     */
+    runIsolatedAgentTurn(prompt: string, options?: AgentExecutionOptions & {
+        sessionLabel?: string;
+        /**
+         * If true, delete the isolated session file after the run completes.
+         * Default: false (KEEP session — matches OpenClaw default).
+         * OpenClaw equivalent: cleanup: "delete" | "keep" in subagent-announce.ts
+         */
+        deleteAfterRun?: boolean;
+    }): Promise<IsolatedTurnResult>;
+    /**
+     * Inject an isolated run's result into the MAIN session as a compact
+     * system message. The main agent sees one summary message and decides
+     * whether to notify the user.
+     *
+     * Pattern: OpenClaw's runSubagentAnnounceFlow — builds a trigger message
+     * from the isolated run output and injects it into the requester session.
+     * See: openclaw/src/agents/subagent-announce.ts lines 917-925
+     */
+    injectIsolatedResult(params: {
+        label: string;
+        summary: string;
+        status: "ok" | "error" | "timeout";
+        durationMs: number;
+        inputTokens?: number;
+        outputTokens?: number;
+    }): Promise<AgentTurnResult>;
     /**
      * Get conversation history
      */
@@ -144,4 +239,14 @@ export declare class Agent {
      */
     private getProviderModel;
 }
+/**
+ * Check if all payloads are just heartbeat ack responses (HEARTBEAT_OK).
+ * Returns true if delivery should be skipped because there's no real content.
+ *
+ * Pattern: OpenClaw's isHeartbeatOnlyResponse (cron/isolated-agent/helpers.ts)
+ */
+export declare function isHeartbeatOnlyResponse(payloads: Array<{
+    text?: string;
+    mediaUrls?: string[];
+}>, ackMaxChars?: number): boolean;
 //# sourceMappingURL=agent.d.ts.map

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

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