@openai/agents-core 0.8.5 → 0.9.0

package/dist/sandbox/memory/prompts.mjs.map

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

package/dist/sandbox/memory/rollouts.d.ts

@@ -0,0 +1,33 @@
+import type { Agent, AgentOutputType } from '../../agent';
+import type { RunState } from '../../runState';
+import type { AgentInputItem } from '../../types';
+export type SandboxMemoryTerminalMetadata = {
+    terminal_state: 'completed' | 'interrupted' | 'cancelled' | 'failed' | 'max_turns_exceeded' | 'guardrail_tripped';
+    exception_type: string | null;
+    exception_message: string | null;
+    has_final_output: boolean;
+};
+export type SandboxMemoryRolloutPayload = {
+    updated_at: string;
+    rollout_id: string;
+    input: unknown;
+    generated_items: unknown;
+    interruptions?: unknown;
+    terminal_metadata: SandboxMemoryTerminalMetadata;
+    final_output?: unknown;
+};
+export type MemoryRolloutIdentity = {
+    conversationId?: string;
+    sdkSessionId?: string;
+    groupId?: string;
+    fallbackId: string;
+};
+export declare function resolveMemoryRolloutId(identity: MemoryRolloutIdentity): string;
+export declare function buildMemoryRolloutPayload<TContext>(state: RunState<TContext, Agent<TContext, AgentOutputType>>, args: {
+    rolloutId: string;
+    exception?: unknown;
+    inputOverride?: string | AgentInputItem[];
+}): SandboxMemoryRolloutPayload;
+export declare function validateRolloutId(value: string): string;
+export declare function normalizeRolloutSlug(value: string): string;
+export declare function renderPhaseOnePrompt(rolloutContents: string): string;

package/dist/sandbox/memory/rollouts.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMemoryRolloutId = resolveMemoryRolloutId;
+exports.buildMemoryRolloutPayload = buildMemoryRolloutPayload;
+exports.validateRolloutId = validateRolloutId;
+exports.normalizeRolloutSlug = normalizeRolloutSlug;
+exports.renderPhaseOnePrompt = renderPhaseOnePrompt;
+const errors_1 = require("../../errors.js");
+const items_1 = require("../../runner/items.js");
+const stableJson_1 = require("../shared/stableJson.js");
+const EXCLUDED_MEMORY_ITEM_TYPES = new Set([
+    'compaction',
+    'image_generation_call',
+    'reasoning',
+]);
+const INCLUDED_MEMORY_ITEM_TYPES = new Set([
+    'apply_patch_call',
+    'apply_patch_call_output',
+    'computer_call',
+    'computer_call_output',
+    'custom_tool_call',
+    'custom_tool_call_output',
+    'function_call',
+    'function_call_output',
+    'function_call_result',
+    'hosted_tool_call',
+    'local_shell_call',
+    'local_shell_call_output',
+    'mcp_approval_request',
+    'mcp_approval_response',
+    'mcp_call',
+    'shell_call',
+    'shell_call_output',
+    'tool_search_call',
+    'tool_search_output',
+    'web_search_call',
+]);
+function resolveMemoryRolloutId(identity) {
+    return validateRolloutId(identity.conversationId ??
+        identity.sdkSessionId ??
+        identity.groupId ??
+        identity.fallbackId);
+}
+function buildMemoryRolloutPayload(state, args) {
+    const finalOutput = finalOutputForMemory(state);
+    const interruptions = interruptionsForMemory(state).map((item) => sanitizeForMemoryJson(item.rawItem));
+    const payload = {
+        updated_at: utcIsoTimestamp(),
+        rollout_id: args.rolloutId,
+        input: sanitizeForMemoryJson(sanitizeMemoryItems((0, items_1.toAgentInputList)(args.inputOverride ?? state._originalInput))),
+        generated_items: sanitizeForMemoryJson(sanitizeMemoryItems((0, items_1.extractOutputItemsFromRunItems)(state._generatedItems, state._reasoningItemIdPolicy))),
+        terminal_metadata: terminalMetadataForMemory(state, args.exception, finalOutput),
+    };
+    if (interruptions.length > 0) {
+        payload.interruptions = interruptions;
+    }
+    if (finalOutput !== null) {
+        payload.final_output = sanitizeForMemoryJson(finalOutput);
+    }
+    return payload;
+}
+function validateRolloutId(value) {
+    const normalized = value.trim();
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(normalized)) {
+        throw new Error("Sandbox memory rollout ID must be a file-safe ID containing only letters, numbers, '.', '_', or '-'.");
+    }
+    return normalized;
+}
+function normalizeRolloutSlug(value) {
+    const slug = value.trim().endsWith('.md')
+        ? value.trim().slice(0, -3)
+        : value.trim();
+    if (!/^[a-z0-9][a-z0-9_-]{0,79}$/.test(slug)) {
+        throw new Error(`Invalid rollout_slug: ${value}`);
+    }
+    return slug;
+}
+function renderPhaseOnePrompt(rolloutContents) {
+    const payloads = rolloutContents
+        .split('\n')
+        .filter((line) => line.trim().length > 0)
+        .map((line) => JSON.parse(line));
+    if (payloads.length === 0) {
+        throw new Error('rollout_contents must contain at least one JSONL record');
+    }
+    const lastPayload = payloads[payloads.length - 1];
+    const terminalMetadata = payloads.length === 1
+        ? (lastPayload.terminal_metadata ?? {})
+        : {
+            segment_count: payloads.length,
+            final_terminal_metadata: lastPayload.terminal_metadata ?? {},
+            terminal_states: payloads.map((payload) => {
+                const terminal = payload.terminal_metadata;
+                return terminal && typeof terminal === 'object'
+                    ? (terminal.terminal_state ??
+                        'unknown')
+                    : 'unknown';
+            }),
+        };
+    return stringifySortedJson(terminalMetadata);
+}
+function sanitizeMemoryItems(items) {
+    return items.filter((item) => shouldIncludeMemoryItem(item));
+}
+function shouldIncludeMemoryItem(item) {
+    if (!item || typeof item !== 'object') {
+        return false;
+    }
+    const role = item.role;
+    if (role === 'developer' || role === 'system') {
+        return false;
+    }
+    if (role === 'assistant' || role === 'tool' || role === 'user') {
+        return true;
+    }
+    const type = item.type;
+    if (typeof type !== 'string') {
+        return false;
+    }
+    if (EXCLUDED_MEMORY_ITEM_TYPES.has(type)) {
+        return false;
+    }
+    return INCLUDED_MEMORY_ITEM_TYPES.has(type);
+}
+function finalOutputForMemory(state) {
+    if (state._currentStep?.type !== 'next_step_final_output') {
+        return null;
+    }
+    return state._currentStep.output;
+}
+function interruptionsForMemory(state) {
+    return state.getInterruptions();
+}
+function terminalMetadataForMemory(state, exception, finalOutput) {
+    if (finalOutput !== null) {
+        return {
+            terminal_state: 'completed',
+            exception_type: null,
+            exception_message: null,
+            has_final_output: true,
+        };
+    }
+    if (state._currentStep?.type === 'next_step_interruption') {
+        return {
+            terminal_state: 'interrupted',
+            exception_type: null,
+            exception_message: null,
+            has_final_output: false,
+        };
+    }
+    if (exception !== undefined) {
+        return terminalMetadataForException(exception);
+    }
+    return {
+        terminal_state: 'failed',
+        exception_type: null,
+        exception_message: null,
+        has_final_output: false,
+    };
+}
+function terminalMetadataForException(exception) {
+    const exceptionType = exceptionName(exception);
+    let terminalState = 'failed';
+    if (exception instanceof errors_1.MaxTurnsExceededError) {
+        terminalState = 'max_turns_exceeded';
+    }
+    else if (exception instanceof errors_1.InputGuardrailTripwireTriggered ||
+        exception instanceof errors_1.OutputGuardrailTripwireTriggered ||
+        exception instanceof errors_1.ToolInputGuardrailTripwireTriggered ||
+        exception instanceof errors_1.ToolOutputGuardrailTripwireTriggered ||
+        exceptionType.includes('Guardrail')) {
+        terminalState = 'guardrail_tripped';
+    }
+    else if (exceptionType === 'AbortError' ||
+        exceptionType === 'CancelledError') {
+        terminalState = 'cancelled';
+    }
+    return {
+        terminal_state: terminalState,
+        exception_type: exceptionType,
+        exception_message: exceptionMessage(exception),
+        has_final_output: false,
+    };
+}
+function exceptionName(exception) {
+    if (exception instanceof Error && exception.name) {
+        return exception.name;
+    }
+    if (exception &&
+        typeof exception === 'object' &&
+        typeof exception.name === 'string') {
+        return exception.name;
+    }
+    return 'Error';
+}
+function exceptionMessage(exception) {
+    if (exception instanceof Error) {
+        return exception.message || null;
+    }
+    const message = String(exception);
+    return message ? message : null;
+}
+function stringifySortedJson(value) {
+    return (0, stableJson_1.stableJsonPrettyStringify)(value, {
+        encodeBytes: (entry) => Object.fromEntries(Object.entries(entry)),
+    });
+}
+function utcIsoTimestamp() {
+    return new Date().toISOString().replace(/Z$/, '+00:00');
+}
+function sanitizeForMemoryJson(value) {
+    try {
+        const serialized = JSON.stringify(value, (_key, childValue) => {
+            if (childValue instanceof Uint8Array) {
+                return {
+                    type: 'Uint8Array',
+                    byteLength: childValue.byteLength,
+                };
+            }
+            return childValue;
+        });
+        return serialized === undefined ? null : JSON.parse(serialized);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=rollouts.js.map

package/dist/sandbox/memory/rollouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollouts.js","sourceRoot":"","sources":["../../../src/sandbox/memory/rollouts.ts"],"names":[],"mappings":";;AA4EA,wDASC;AAED,8DAyCC;AAED,8CAQC;AAED,oDAQC;AAED,oDAwBC;AA7KD,4CAMsB;AAItB,iDAG4B;AAC5B,wDAAiE;AAEjE,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,YAAY;IACZ,uBAAuB;IACvB,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,kBAAkB;IAClB,yBAAyB;IACzB,eAAe;IACf,sBAAsB;IACtB,kBAAkB;IAClB,yBAAyB;IACzB,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,kBAAkB;IAClB,kBAAkB;IAClB,yBAAyB;IACzB,sBAAsB;IACtB,uBAAuB;IACvB,UAAU;IACV,YAAY;IACZ,mBAAmB;IACnB,kBAAkB;IAClB,oBAAoB;IACpB,iBAAiB;CAClB,CAAC,CAAC;AAgCH,SAAgB,sBAAsB,CACpC,QAA+B;IAE/B,OAAO,iBAAiB,CACtB,QAAQ,CAAC,cAAc;QACrB,QAAQ,CAAC,YAAY;QACrB,QAAQ,CAAC,OAAO;QAChB,QAAQ,CAAC,UAAU,CACtB,CAAC;AACJ,CAAC;AAED,SAAgB,yBAAyB,CACvC,KAA2D,EAC3D,IAIC;IAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/D,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CACpC,CAAC;IACF,MAAM,OAAO,GAAgC;QAC3C,UAAU,EAAE,eAAe,EAAE;QAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;QAC1B,KAAK,EAAE,qBAAqB,CAC1B,mBAAmB,CACjB,IAAA,wBAAgB,EAAC,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,cAAc,CAAC,CAC7D,CACF;QACD,eAAe,EAAE,qBAAqB,CACpC,mBAAmB,CACjB,IAAA,sCAA8B,EAC5B,KAAK,CAAC,eAAe,EACrB,KAAK,CAAC,sBAAsB,CAC7B,CACF,CACF;QACD,iBAAiB,EAAE,yBAAyB,CAC1C,KAAK,EACL,IAAI,CAAC,SAAS,EACd,WAAW,CACZ;KACF,CAAC;IACF,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IACxC,CAAC;IACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,CAAC,YAAY,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAa;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACjB,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,oBAAoB,CAAC,eAAuB;IAC1D,MAAM,QAAQ,GAAG,eAAe;SAC7B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAmC,CAAC;IACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,gBAAgB,GACpB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,CAAC,WAAW,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACvC,CAAC,CAAC;YACE,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,uBAAuB,EAAE,WAAW,CAAC,iBAAiB,IAAI,EAAE;YAC5D,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;gBAC3C,OAAO,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;oBAC7C,CAAC,CAAC,CAAE,QAAoC,CAAC,cAAc;wBACnD,SAAS,CAAC;oBACd,CAAC,CAAC,SAAS,CAAC;YAChB,CAAC,CAAC;SACH,CAAC;IACR,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAuB;IAClD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAoB;IACnD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;IAC/C,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;IAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA2D;IAE3D,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,KAAK,wBAAwB,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;AACnC,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAA2D;IAE3D,OAAO,KAAK,CAAC,gBAAgB,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,yBAAyB,CAChC,KAA2D,EAC3D,SAAkB,EAClB,WAAoB;IAEpB,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO;YACL,cAAc,EAAE,WAAW;YAC3B,cAAc,EAAE,IAAI;YACpB,iBAAiB,EAAE,IAAI;YACvB,gBAAgB,EAAE,IAAI;SACvB,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,KAAK,wBAAwB,EAAE,CAAC;QAC1D,OAAO;YACL,cAAc,EAAE,aAAa;YAC7B,cAAc,EAAE,IAAI;YACpB,iBAAiB,EAAE,IAAI;YACvB,gBAAgB,EAAE,KAAK;SACxB,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,4BAA4B,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IACD,OAAO;QACL,cAAc,EAAE,QAAQ;QACxB,cAAc,EAAE,IAAI;QACpB,iBAAiB,EAAE,IAAI;QACvB,gBAAgB,EAAE,KAAK;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,SAAkB;IAElB,MAAM,aAAa,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,aAAa,GAAoD,QAAQ,CAAC;IAC9E,IAAI,SAAS,YAAY,8BAAqB,EAAE,CAAC;QAC/C,aAAa,GAAG,oBAAoB,CAAC;IACvC,CAAC;SAAM,IACL,SAAS,YAAY,wCAA+B;QACpD,SAAS,YAAY,yCAAgC;QACrD,SAAS,YAAY,4CAAmC;QACxD,SAAS,YAAY,6CAAoC;QACzD,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,EACnC,CAAC;QACD,aAAa,GAAG,mBAAmB,CAAC;IACtC,CAAC;SAAM,IACL,aAAa,KAAK,YAAY;QAC9B,aAAa,KAAK,gBAAgB,EAClC,CAAC;QACD,aAAa,GAAG,WAAW,CAAC;IAC9B,CAAC;IACD,OAAO;QACL,cAAc,EAAE,aAAa;QAC7B,cAAc,EAAE,aAAa;QAC7B,iBAAiB,EAAE,gBAAgB,CAAC,SAAS,CAAC;QAC9C,gBAAgB,EAAE,KAAK;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,SAAkB;IACvC,IAAI,SAAS,YAAY,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC,IAAI,CAAC;IACxB,CAAC;IACD,IACE,SAAS;QACT,OAAO,SAAS,KAAK,QAAQ;QAC7B,OAAQ,SAAgC,CAAC,IAAI,KAAK,QAAQ,EAC1D,CAAC;QACD,OAAQ,SAA8B,CAAC,IAAI,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAkB;IAC1C,IAAI,SAAS,YAAY,KAAK,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC;IACnC,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,IAAA,sCAAyB,EAAC,KAAK,EAAE;QACtC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;KAClE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;YAC5D,IAAI,UAAU,YAAY,UAAU,EAAE,CAAC;gBACrC,OAAO;oBACL,IAAI,EAAE,YAAY;oBAClB,UAAU,EAAE,UAAU,CAAC,UAAU;iBAClC,CAAC;YACJ,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/sandbox/memory/rollouts.mjs

@@ -0,0 +1,221 @@
+import { InputGuardrailTripwireTriggered, MaxTurnsExceededError, OutputGuardrailTripwireTriggered, ToolInputGuardrailTripwireTriggered, ToolOutputGuardrailTripwireTriggered, } from "../../errors.mjs";
+import { extractOutputItemsFromRunItems, toAgentInputList, } from "../../runner/items.mjs";
+import { stableJsonPrettyStringify } from "../shared/stableJson.mjs";
+const EXCLUDED_MEMORY_ITEM_TYPES = new Set([
+    'compaction',
+    'image_generation_call',
+    'reasoning',
+]);
+const INCLUDED_MEMORY_ITEM_TYPES = new Set([
+    'apply_patch_call',
+    'apply_patch_call_output',
+    'computer_call',
+    'computer_call_output',
+    'custom_tool_call',
+    'custom_tool_call_output',
+    'function_call',
+    'function_call_output',
+    'function_call_result',
+    'hosted_tool_call',
+    'local_shell_call',
+    'local_shell_call_output',
+    'mcp_approval_request',
+    'mcp_approval_response',
+    'mcp_call',
+    'shell_call',
+    'shell_call_output',
+    'tool_search_call',
+    'tool_search_output',
+    'web_search_call',
+]);
+export function resolveMemoryRolloutId(identity) {
+    return validateRolloutId(identity.conversationId ??
+        identity.sdkSessionId ??
+        identity.groupId ??
+        identity.fallbackId);
+}
+export function buildMemoryRolloutPayload(state, args) {
+    const finalOutput = finalOutputForMemory(state);
+    const interruptions = interruptionsForMemory(state).map((item) => sanitizeForMemoryJson(item.rawItem));
+    const payload = {
+        updated_at: utcIsoTimestamp(),
+        rollout_id: args.rolloutId,
+        input: sanitizeForMemoryJson(sanitizeMemoryItems(toAgentInputList(args.inputOverride ?? state._originalInput))),
+        generated_items: sanitizeForMemoryJson(sanitizeMemoryItems(extractOutputItemsFromRunItems(state._generatedItems, state._reasoningItemIdPolicy))),
+        terminal_metadata: terminalMetadataForMemory(state, args.exception, finalOutput),
+    };
+    if (interruptions.length > 0) {
+        payload.interruptions = interruptions;
+    }
+    if (finalOutput !== null) {
+        payload.final_output = sanitizeForMemoryJson(finalOutput);
+    }
+    return payload;
+}
+export function validateRolloutId(value) {
+    const normalized = value.trim();
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(normalized)) {
+        throw new Error("Sandbox memory rollout ID must be a file-safe ID containing only letters, numbers, '.', '_', or '-'.");
+    }
+    return normalized;
+}
+export function normalizeRolloutSlug(value) {
+    const slug = value.trim().endsWith('.md')
+        ? value.trim().slice(0, -3)
+        : value.trim();
+    if (!/^[a-z0-9][a-z0-9_-]{0,79}$/.test(slug)) {
+        throw new Error(`Invalid rollout_slug: ${value}`);
+    }
+    return slug;
+}
+export function renderPhaseOnePrompt(rolloutContents) {
+    const payloads = rolloutContents
+        .split('\n')
+        .filter((line) => line.trim().length > 0)
+        .map((line) => JSON.parse(line));
+    if (payloads.length === 0) {
+        throw new Error('rollout_contents must contain at least one JSONL record');
+    }
+    const lastPayload = payloads[payloads.length - 1];
+    const terminalMetadata = payloads.length === 1
+        ? (lastPayload.terminal_metadata ?? {})
+        : {
+            segment_count: payloads.length,
+            final_terminal_metadata: lastPayload.terminal_metadata ?? {},
+            terminal_states: payloads.map((payload) => {
+                const terminal = payload.terminal_metadata;
+                return terminal && typeof terminal === 'object'
+                    ? (terminal.terminal_state ??
+                        'unknown')
+                    : 'unknown';
+            }),
+        };
+    return stringifySortedJson(terminalMetadata);
+}
+function sanitizeMemoryItems(items) {
+    return items.filter((item) => shouldIncludeMemoryItem(item));
+}
+function shouldIncludeMemoryItem(item) {
+    if (!item || typeof item !== 'object') {
+        return false;
+    }
+    const role = item.role;
+    if (role === 'developer' || role === 'system') {
+        return false;
+    }
+    if (role === 'assistant' || role === 'tool' || role === 'user') {
+        return true;
+    }
+    const type = item.type;
+    if (typeof type !== 'string') {
+        return false;
+    }
+    if (EXCLUDED_MEMORY_ITEM_TYPES.has(type)) {
+        return false;
+    }
+    return INCLUDED_MEMORY_ITEM_TYPES.has(type);
+}
+function finalOutputForMemory(state) {
+    if (state._currentStep?.type !== 'next_step_final_output') {
+        return null;
+    }
+    return state._currentStep.output;
+}
+function interruptionsForMemory(state) {
+    return state.getInterruptions();
+}
+function terminalMetadataForMemory(state, exception, finalOutput) {
+    if (finalOutput !== null) {
+        return {
+            terminal_state: 'completed',
+            exception_type: null,
+            exception_message: null,
+            has_final_output: true,
+        };
+    }
+    if (state._currentStep?.type === 'next_step_interruption') {
+        return {
+            terminal_state: 'interrupted',
+            exception_type: null,
+            exception_message: null,
+            has_final_output: false,
+        };
+    }
+    if (exception !== undefined) {
+        return terminalMetadataForException(exception);
+    }
+    return {
+        terminal_state: 'failed',
+        exception_type: null,
+        exception_message: null,
+        has_final_output: false,
+    };
+}
+function terminalMetadataForException(exception) {
+    const exceptionType = exceptionName(exception);
+    let terminalState = 'failed';
+    if (exception instanceof MaxTurnsExceededError) {
+        terminalState = 'max_turns_exceeded';
+    }
+    else if (exception instanceof InputGuardrailTripwireTriggered ||
+        exception instanceof OutputGuardrailTripwireTriggered ||
+        exception instanceof ToolInputGuardrailTripwireTriggered ||
+        exception instanceof ToolOutputGuardrailTripwireTriggered ||
+        exceptionType.includes('Guardrail')) {
+        terminalState = 'guardrail_tripped';
+    }
+    else if (exceptionType === 'AbortError' ||
+        exceptionType === 'CancelledError') {
+        terminalState = 'cancelled';
+    }
+    return {
+        terminal_state: terminalState,
+        exception_type: exceptionType,
+        exception_message: exceptionMessage(exception),
+        has_final_output: false,
+    };
+}
+function exceptionName(exception) {
+    if (exception instanceof Error && exception.name) {
+        return exception.name;
+    }
+    if (exception &&
+        typeof exception === 'object' &&
+        typeof exception.name === 'string') {
+        return exception.name;
+    }
+    return 'Error';
+}
+function exceptionMessage(exception) {
+    if (exception instanceof Error) {
+        return exception.message || null;
+    }
+    const message = String(exception);
+    return message ? message : null;
+}
+function stringifySortedJson(value) {
+    return stableJsonPrettyStringify(value, {
+        encodeBytes: (entry) => Object.fromEntries(Object.entries(entry)),
+    });
+}
+function utcIsoTimestamp() {
+    return new Date().toISOString().replace(/Z$/, '+00:00');
+}
+function sanitizeForMemoryJson(value) {
+    try {
+        const serialized = JSON.stringify(value, (_key, childValue) => {
+            if (childValue instanceof Uint8Array) {
+                return {
+                    type: 'Uint8Array',
+                    byteLength: childValue.byteLength,
+                };
+            }
+            return childValue;
+        });
+        return serialized === undefined ? null : JSON.parse(serialized);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=rollouts.mjs.map

package/dist/sandbox/memory/rollouts.mjs.map

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

package/dist/sandbox/memory/storage.d.ts

@@ -0,0 +1,70 @@
+import type { SandboxDirectoryEntry, SandboxSessionLike, SandboxSessionState } from '../session';
+import type { Memory } from '../capabilities/memory';
+export type PhaseTwoSelectionItem = {
+    rolloutId: string;
+    updatedAt: string;
+    rolloutPath: string;
+    rolloutSummaryFile: string;
+    terminalState: string;
+};
+export type PhaseTwoInputSelection = {
+    selected: PhaseTwoSelectionItem[];
+    retainedRolloutIds: Set<string>;
+    removed: PhaseTwoSelectionItem[];
+};
+export interface MemoryStore {
+    read(path: string): Promise<Uint8Array | null>;
+    write(path: string, data: Uint8Array): Promise<void>;
+    delete?(path: string): Promise<void>;
+    list?(prefix: string): Promise<string[]>;
+}
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private readonly files;
+    read(path: string): Promise<Uint8Array | null>;
+    write(path: string, data: Uint8Array): Promise<void>;
+    delete(path: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+}
+export declare class SandboxMemoryStorage {
+    private readonly session;
+    private runAs?;
+    private readonly store?;
+    private readonly appendQueues;
+    constructor(args: {
+        session: SandboxSessionLike<SandboxSessionState>;
+        runAs?: string;
+        store?: MemoryStore;
+    });
+    updateRuntimeContext(args: {
+        runAs?: string;
+    }): void;
+    ensureLayout(memory: Memory): Promise<void>;
+    appendJsonl(path: string, payload: unknown): Promise<void>;
+    readText(path: string): Promise<string | null>;
+    private readFullText;
+    private runQueuedAppend;
+    writeText(path: string, content: string): Promise<void>;
+    listDir(path: string): Promise<SandboxDirectoryEntry[]>;
+    hydrateFromStore(prefix: string): Promise<void>;
+    private listStoreDirectory;
+    buildPhaseTwoInputSelection(args: {
+        memoriesDir: string;
+        maxRawMemoriesForConsolidation: number;
+    }): Promise<PhaseTwoInputSelection>;
+    rebuildRawMemories(args: {
+        memoriesDir: string;
+        selectedItems: PhaseTwoSelectionItem[];
+    }): Promise<boolean>;
+    writePhaseTwoSelection(args: {
+        memoriesDir: string;
+        selectedItems: PhaseTwoSelectionItem[];
+    }): Promise<void>;
+    private ensureDir;
+    private ensureFile;
+    private readTextWithShell;
+    private appendJsonlWithShell;
+    private appendJsonlToStore;
+    private readPhaseTwoSelection;
+    private listCurrentSelectionItems;
+}
+export declare function joinRelativePaths(left: string, right: string, ...rest: string[]): string;