@openai/agents-core 0.8.5 → 0.9.1

package/dist/sandbox/capabilities/shell.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shell = shell;
+const zod_1 = require("zod");
+const errors_1 = require("../../errors.js");
+const tool_1 = require("../../tool.js");
+const spans_1 = require("../runtime/spans.js");
+const base_1 = require("./base.js");
+const DEFAULT_EXEC_YIELD_TIME_MS = 10_000;
+const DEFAULT_WRITE_STDIN_YIELD_TIME_MS = 250;
+const SHELL_INSTRUCTIONS = [
+    'When using the shell:',
+    '- Use `exec_command` for shell execution.',
+    '- If available, use `write_stdin` to interact with or poll running sessions.',
+    '- To interrupt a long-running process via `write_stdin`, start it with `tty=true` and send Ctrl-C (`\\u0003`).',
+    '- Prefer `rg` and `rg --files` for text/file discovery when available.',
+    '- Avoid using Python scripts just to print large file chunks.',
+].join('\n');
+class ShellCapability extends base_1.Capability {
+    type = 'shell';
+    configureTools;
+    constructor(args = {}) {
+        super();
+        this.configureTools = args.configureTools;
+    }
+    tools() {
+        const session = (0, base_1.requireBoundSession)(this.type, this._session);
+        if (!session.execCommand) {
+            throw new errors_1.UserError('Shell sandbox sessions must provide execCommand().');
+        }
+        const tools = [
+            (0, tool_1.tool)({
+                name: 'exec_command',
+                description: 'Runs a command in a PTY, returning output or a session ID for ongoing interaction.',
+                parameters: zod_1.z.object({
+                    cmd: zod_1.z.string().min(1).describe('Shell command to execute.'),
+                    workdir: zod_1.z
+                        .string()
+                        .optional()
+                        .describe('Optional working directory to run the command in; defaults to the turn cwd.'),
+                    shell: zod_1.z
+                        .string()
+                        .optional()
+                        .describe("Shell binary to launch. Defaults to the user's default shell."),
+                    login: zod_1.z
+                        .boolean()
+                        .default(true)
+                        .describe('Whether to run the shell with -l/-i semantics. Defaults to true.'),
+                    tty: zod_1.z
+                        .boolean()
+                        .default(false)
+                        .describe('Whether to allocate a TTY for the command. Defaults to false (plain pipes); set to true to open a PTY and access TTY process.'),
+                    yield_time_ms: zod_1.z
+                        .number()
+                        .int()
+                        .min(0)
+                        .default(DEFAULT_EXEC_YIELD_TIME_MS)
+                        .describe('How long to wait (in milliseconds) for output before yielding.'),
+                    max_output_tokens: zod_1.z
+                        .number()
+                        .int()
+                        .min(1)
+                        .optional()
+                        .describe('Maximum number of tokens to return. Excess output will be truncated.'),
+                }),
+                execute: async ({ cmd, workdir, shell, login, tty, yield_time_ms, max_output_tokens, }) => await (0, spans_1.withSandboxSpan)('sandbox.exec', {
+                    cmd,
+                    workdir,
+                    shell,
+                    login,
+                    tty,
+                    run_as: this._runAs,
+                }, async () => await session.execCommand({
+                    cmd,
+                    workdir,
+                    shell,
+                    login,
+                    tty,
+                    yieldTimeMs: yield_time_ms,
+                    maxOutputTokens: max_output_tokens,
+                    runAs: this._runAs,
+                })),
+            }),
+        ];
+        if (session.supportsPty?.() && session.writeStdin) {
+            tools.push((0, tool_1.tool)({
+                name: 'write_stdin',
+                description: 'Writes characters to an existing unified exec session and returns recent output.',
+                parameters: zod_1.z.object({
+                    session_id: zod_1.z
+                        .number()
+                        .int()
+                        .describe('Identifier of the running unified exec session.'),
+                    chars: zod_1.z
+                        .string()
+                        .default('')
+                        .describe('Bytes to write to stdin (may be empty to poll).'),
+                    yield_time_ms: zod_1.z
+                        .number()
+                        .int()
+                        .min(0)
+                        .default(DEFAULT_WRITE_STDIN_YIELD_TIME_MS)
+                        .describe('How long to wait (in milliseconds) for output before yielding.'),
+                    max_output_tokens: zod_1.z
+                        .number()
+                        .int()
+                        .min(1)
+                        .optional()
+                        .describe('Maximum number of tokens to return. Excess output will be truncated.'),
+                }),
+                execute: async ({ session_id, chars, yield_time_ms, max_output_tokens, }) => await (0, spans_1.withSandboxSpan)('sandbox.write_stdin', {
+                    session_id,
+                }, async () => await session.writeStdin({
+                    sessionId: session_id,
+                    chars,
+                    yieldTimeMs: yield_time_ms,
+                    maxOutputTokens: max_output_tokens,
+                })),
+            }));
+        }
+        return this.configureTools ? this.configureTools([...tools]) : tools;
+    }
+    instructions() {
+        return SHELL_INSTRUCTIONS;
+    }
+}
+function shell(args = {}) {
+    return new ShellCapability(args);
+}
+//# sourceMappingURL=shell.js.map

package/dist/sandbox/capabilities/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/sandbox/capabilities/shell.ts"],"names":[],"mappings":";;AA0MA,sBAEC;AA5MD,6BAAwB;AACxB,4CAAyC;AACzC,wCAA6C;AAE7C,+CAAmD;AACnD,oCAIgB;AAEhB,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAE9C,MAAM,kBAAkB,GAAG;IACzB,uBAAuB;IACvB,2CAA2C;IAC3C,8EAA8E;IAC9E,gHAAgH;IAChH,wEAAwE;IACxE,+DAA+D;CAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAMb,MAAM,eAAgB,SAAQ,iBAAU;IAC7B,IAAI,GAAG,OAAO,CAAC;IACP,cAAc,CAA4B;IAE3D,YAAY,OAAkB,EAAE;QAC9B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC5C,CAAC;IAEQ,KAAK;QACZ,MAAM,OAAO,GAAG,IAAA,0BAAmB,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,kBAAS,CAAC,oDAAoD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,KAAK,GAAgB;YACzB,IAAA,WAAI,EAAC;gBACH,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,oFAAoF;gBACtF,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;oBACnB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;oBAC5D,OAAO,EAAE,OAAC;yBACP,MAAM,EAAE;yBACR,QAAQ,EAAE;yBACV,QAAQ,CACP,6EAA6E,CAC9E;oBACH,KAAK,EAAE,OAAC;yBACL,MAAM,EAAE;yBACR,QAAQ,EAAE;yBACV,QAAQ,CACP,+DAA+D,CAChE;oBACH,KAAK,EAAE,OAAC;yBACL,OAAO,EAAE;yBACT,OAAO,CAAC,IAAI,CAAC;yBACb,QAAQ,CACP,kEAAkE,CACnE;oBACH,GAAG,EAAE,OAAC;yBACH,OAAO,EAAE;yBACT,OAAO,CAAC,KAAK,CAAC;yBACd,QAAQ,CACP,+HAA+H,CAChI;oBACH,aAAa,EAAE,OAAC;yBACb,MAAM,EAAE;yBACR,GAAG,EAAE;yBACL,GAAG,CAAC,CAAC,CAAC;yBACN,OAAO,CAAC,0BAA0B,CAAC;yBACnC,QAAQ,CACP,gEAAgE,CACjE;oBACH,iBAAiB,EAAE,OAAC;yBACjB,MAAM,EAAE;yBACR,GAAG,EAAE;yBACL,GAAG,CAAC,CAAC,CAAC;yBACN,QAAQ,EAAE;yBACV,QAAQ,CACP,sEAAsE,CACvE;iBACJ,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EACd,GAAG,EACH,OAAO,EACP,KAAK,EACL,KAAK,EACL,GAAG,EACH,aAAa,EACb,iBAAiB,GASlB,EAAmB,EAAE,CACpB,MAAM,IAAA,uBAAe,EACnB,cAAc,EACd;oBACE,GAAG;oBACH,OAAO;oBACP,KAAK;oBACL,KAAK;oBACL,GAAG;oBACH,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,EACD,KAAK,IAAI,EAAE,CACT,MAAM,OAAO,CAAC,WAAY,CAAC;oBACzB,GAAG;oBACH,OAAO;oBACP,KAAK;oBACL,KAAK;oBACL,GAAG;oBACH,WAAW,EAAE,aAAa;oBAC1B,eAAe,EAAE,iBAAiB;oBAClC,KAAK,EAAE,IAAI,CAAC,MAAM;iBACO,CAAC,CAC/B;aACJ,CAAC;SACH,CAAC;QAEF,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CACR,IAAA,WAAI,EAAC;gBACH,IAAI,EAAE,aAAa;gBACnB,WAAW,EACT,kFAAkF;gBACpF,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;oBACnB,UAAU,EAAE,OAAC;yBACV,MAAM,EAAE;yBACR,GAAG,EAAE;yBACL,QAAQ,CAAC,iDAAiD,CAAC;oBAC9D,KAAK,EAAE,OAAC;yBACL,MAAM,EAAE;yBACR,OAAO,CAAC,EAAE,CAAC;yBACX,QAAQ,CAAC,iDAAiD,CAAC;oBAC9D,aAAa,EAAE,OAAC;yBACb,MAAM,EAAE;yBACR,GAAG,EAAE;yBACL,GAAG,CAAC,CAAC,CAAC;yBACN,OAAO,CAAC,iCAAiC,CAAC;yBAC1C,QAAQ,CACP,gEAAgE,CACjE;oBACH,iBAAiB,EAAE,OAAC;yBACjB,MAAM,EAAE;yBACR,GAAG,EAAE;yBACL,GAAG,CAAC,CAAC,CAAC;yBACN,QAAQ,EAAE;yBACV,QAAQ,CACP,sEAAsE,CACvE;iBACJ,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EACd,UAAU,EACV,KAAK,EACL,aAAa,EACb,iBAAiB,GAMlB,EAAmB,EAAE,CACpB,MAAM,IAAA,uBAAe,EACnB,qBAAqB,EACrB;oBACE,UAAU;iBACX,EACD,KAAK,IAAI,EAAE,CACT,MAAM,OAAO,CAAC,UAAW,CAAC;oBACxB,SAAS,EAAE,UAAU;oBACrB,KAAK;oBACL,WAAW,EAAE,aAAa;oBAC1B,eAAe,EAAE,iBAAiB;iBACV,CAAC,CAC9B;aACJ,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACvE,CAAC;IAEQ,YAAY;QACnB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;CACF;AAID,SAAgB,KAAK,CAAC,OAAkB,EAAE;IACxC,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/sandbox/capabilities/shell.mjs

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { UserError } from "../../errors.mjs";
+import { tool } from "../../tool.mjs";
+import { withSandboxSpan } from "../runtime/spans.mjs";
+import { Capability, requireBoundSession, } from "./base.mjs";
+const DEFAULT_EXEC_YIELD_TIME_MS = 10_000;
+const DEFAULT_WRITE_STDIN_YIELD_TIME_MS = 250;
+const SHELL_INSTRUCTIONS = [
+    'When using the shell:',
+    '- Use `exec_command` for shell execution.',
+    '- If available, use `write_stdin` to interact with or poll running sessions.',
+    '- To interrupt a long-running process via `write_stdin`, start it with `tty=true` and send Ctrl-C (`\\u0003`).',
+    '- Prefer `rg` and `rg --files` for text/file discovery when available.',
+    '- Avoid using Python scripts just to print large file chunks.',
+].join('\n');
+class ShellCapability extends Capability {
+    type = 'shell';
+    configureTools;
+    constructor(args = {}) {
+        super();
+        this.configureTools = args.configureTools;
+    }
+    tools() {
+        const session = requireBoundSession(this.type, this._session);
+        if (!session.execCommand) {
+            throw new UserError('Shell sandbox sessions must provide execCommand().');
+        }
+        const tools = [
+            tool({
+                name: 'exec_command',
+                description: 'Runs a command in a PTY, returning output or a session ID for ongoing interaction.',
+                parameters: z.object({
+                    cmd: z.string().min(1).describe('Shell command to execute.'),
+                    workdir: z
+                        .string()
+                        .optional()
+                        .describe('Optional working directory to run the command in; defaults to the turn cwd.'),
+                    shell: z
+                        .string()
+                        .optional()
+                        .describe("Shell binary to launch. Defaults to the user's default shell."),
+                    login: z
+                        .boolean()
+                        .default(true)
+                        .describe('Whether to run the shell with -l/-i semantics. Defaults to true.'),
+                    tty: z
+                        .boolean()
+                        .default(false)
+                        .describe('Whether to allocate a TTY for the command. Defaults to false (plain pipes); set to true to open a PTY and access TTY process.'),
+                    yield_time_ms: z
+                        .number()
+                        .int()
+                        .min(0)
+                        .default(DEFAULT_EXEC_YIELD_TIME_MS)
+                        .describe('How long to wait (in milliseconds) for output before yielding.'),
+                    max_output_tokens: z
+                        .number()
+                        .int()
+                        .min(1)
+                        .optional()
+                        .describe('Maximum number of tokens to return. Excess output will be truncated.'),
+                }),
+                execute: async ({ cmd, workdir, shell, login, tty, yield_time_ms, max_output_tokens, }) => await withSandboxSpan('sandbox.exec', {
+                    cmd,
+                    workdir,
+                    shell,
+                    login,
+                    tty,
+                    run_as: this._runAs,
+                }, async () => await session.execCommand({
+                    cmd,
+                    workdir,
+                    shell,
+                    login,
+                    tty,
+                    yieldTimeMs: yield_time_ms,
+                    maxOutputTokens: max_output_tokens,
+                    runAs: this._runAs,
+                })),
+            }),
+        ];
+        if (session.supportsPty?.() && session.writeStdin) {
+            tools.push(tool({
+                name: 'write_stdin',
+                description: 'Writes characters to an existing unified exec session and returns recent output.',
+                parameters: z.object({
+                    session_id: z
+                        .number()
+                        .int()
+                        .describe('Identifier of the running unified exec session.'),
+                    chars: z
+                        .string()
+                        .default('')
+                        .describe('Bytes to write to stdin (may be empty to poll).'),
+                    yield_time_ms: z
+                        .number()
+                        .int()
+                        .min(0)
+                        .default(DEFAULT_WRITE_STDIN_YIELD_TIME_MS)
+                        .describe('How long to wait (in milliseconds) for output before yielding.'),
+                    max_output_tokens: z
+                        .number()
+                        .int()
+                        .min(1)
+                        .optional()
+                        .describe('Maximum number of tokens to return. Excess output will be truncated.'),
+                }),
+                execute: async ({ session_id, chars, yield_time_ms, max_output_tokens, }) => await withSandboxSpan('sandbox.write_stdin', {
+                    session_id,
+                }, async () => await session.writeStdin({
+                    sessionId: session_id,
+                    chars,
+                    yieldTimeMs: yield_time_ms,
+                    maxOutputTokens: max_output_tokens,
+                })),
+            }));
+        }
+        return this.configureTools ? this.configureTools([...tools]) : tools;
+    }
+    instructions() {
+        return SHELL_INSTRUCTIONS;
+    }
+}
+export function shell(args = {}) {
+    return new ShellCapability(args);
+}
+//# sourceMappingURL=shell.mjs.map

package/dist/sandbox/capabilities/shell.mjs.map

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

package/dist/sandbox/capabilities/skills.d.ts

@@ -0,0 +1,47 @@
+import { type Tool } from '../../tool';
+import { type Dir, type Entry, type File, type GitRepo, type LocalDir, type LocalFile } from '../entries';
+import { type Manifest } from '../manifest';
+import { Capability } from './base';
+export type SkillIndexEntry = {
+    name: string;
+    description: string;
+    path?: string;
+};
+export type LocalDirLazySkillSource = {
+    source: Dir | LocalDir | GitRepo;
+    index?: SkillIndexEntry[];
+};
+export type SkillDescriptor = {
+    name: string;
+    description: string;
+    content: string | Uint8Array | File | LocalFile;
+    scripts?: Record<string, Entry>;
+    references?: Record<string, Entry>;
+    assets?: Record<string, Entry>;
+    compatibility?: string[];
+    deferred?: boolean;
+};
+export type SkillsArgs = {
+    skills?: SkillDescriptor[];
+    from?: Entry;
+    lazyFrom?: LocalDirLazySkillSource;
+    index?: SkillIndexEntry[];
+    skillsPath?: string;
+};
+declare class SkillsCapability extends Capability {
+    readonly type = "skills";
+    readonly skills: SkillDescriptor[];
+    readonly from?: Entry;
+    readonly lazyFrom?: LocalDirLazySkillSource;
+    readonly index?: SkillIndexEntry[];
+    readonly skillsPath: string;
+    constructor(args: SkillsArgs);
+    tools(): Tool<any>[];
+    processManifest(manifest: Manifest): Manifest;
+    instructions(manifest: Manifest): Promise<string | null>;
+    private resolveRuntimeMetadata;
+}
+export type Skills = SkillsCapability;
+export declare function skills(args: SkillsArgs): Skills;
+export declare function parseSkillFrontmatter(markdown: string): Record<string, string>;
+export {};