@sema-agent/core 1.450.0 → 1.451.0

package/dist/core/runner/prepare-task.js

@@ -892,6 +892,7 @@ export async function prepareTask(spec, deps, sessions, resume, _memorySelector,
                 parentModel: () => harnessRef.current?.getModel(),
                 ...(spec.getApiKeyAndHeaders !== undefined ? { parentGetApiKeyAndHeaders: spec.getApiKeyAndHeaders } : {}),
                 principal: spec.principal,
+                oneShot: spec.oneShot,
                 workflowDepth: internals?.workflowDepth,
                 parentCwd: taskRootPath,
                 parentThinking: () => harnessRef.current?.getThinkingLevel() ?? thinking,

package/dist/core/types.d.ts

@@ -231,6 +231,7 @@ export interface TaskSpec {
     images?: ImageInput[];
     sessionId?: string;
     requireExistingSession?: boolean;
+    oneShot?: boolean;
     clientContext?: {
         timeZone?: string;
         userEmail?: string;

package/dist/orchestration/run-workflow-tool.d.ts

@@ -78,6 +78,7 @@ export interface RunWorkflowToolDeps {
     sizeGuideline?: WorkflowSizeGuideline;
     sourceTaskId?: string;
     principal?: string;
+    oneShot?: boolean;
     workflowDepth?: number;
     parentCwd?: string;
     parentThinking?: () => import("../core/types.js").TaskSpec["thinking"];

package/dist/orchestration/run-workflow-tool.js

@@ -524,10 +524,16 @@ export async function createRunWorkflowTool(d) {
                     ...(persistedScriptPath !== undefined ? { scriptPath: persistedScriptPath } : {}),
                     note: (() => {
                         const pollExpr = d.taskRegistry ? `TaskOutput({ task_id: "${runId}" })` : undefined;
+                        const blockingPollExpr = d.taskRegistry ? `TaskOutput({ task_id: "${runId}", block: true })` : undefined;
                         const journalRef = d.journalStore?.locator?.(runId, taskScope ?? d.scope ?? "");
                         const carries = pollExpr
                             ? ` A terminal ${pollExpr} reply carries its result AND per-agent rows — read them${journalRef !== undefined ? ` (full journal: ${journalRef})` : ""} before assuming an empty or unexpected result.`
                             : "";
+                        if (d.oneShot === true) {
+                            return blockingPollExpr
+                                ? `This is a ONE-SHOT submission (e.g. headless \`-p\`) — there is no later turn for a background notification to land in, so do NOT end your turn expecting one. Actively wait instead: ${blockingPollExpr}. If it is still running after the wait, wait again (bounded) rather than ending the turn, or write out your best available answer now if you are near your own time budget.${carries}`
+                                : "This is a one-shot submission (e.g. headless `-p`) and no poll path is available — the workflow's outcome may not be recoverable after this turn ends.";
+                        }
                         if (d.notifier) {
                             return `The workflow runs asynchronously. You will be NOTIFIED when it completes (the notification carries the result). End your turn and wait — do not poll unless the user asks for progress.${carries}`;
                         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "1.450.0",
+  "version": "1.451.0",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",