@anhlp/alp-runtime 0.0.1-beta.3 → 0.0.1-beta.4

package/src/session-config.ts

@@ -5,7 +5,7 @@ import type { ResolvedSession, RuntimeKind } from './resolve.js';
 import { models, thinkingOptionsFor } from './catalog.js';
 import { claudeSandboxAvailable, SKILL_PLUGIN } from './claude-transport.js';
 import { languageInstruction } from './language.js';
-import { HANDOFF_TOOL, WAIT_TOOL, SEND_TOOL, MERGE_TOOL, VERIFY_TOOL, DISCARD_TOOL, CANCEL_TOOL, RECALL_TOOL, PIN_TOOL, BOARD_TOOL, UNPIN_TOOL, ASK_TOOL, LESSON_TOOL, SKILL_TOOL, ISSUE_TOOL, mainOf, taskActions, taskTool } from './tools.js';
+import { HANDOFF_TOOL, WAIT_TOOL, SEND_TOOL, MERGE_TOOL, VERIFY_TOOL, DISCARD_TOOL, CANCEL_TOOL, RECALL_TOOL, PIN_TOOL, BOARD_TOOL, UNPIN_TOOL, ASK_TOOL, LESSON_TOOL, SKILL_TOOL, ISSUE_TOOL, SCHEDULE_TOOL, mainOf, taskActions, taskTool } from './tools.js';
 
 import { COMPACT_SHARE } from './runtime-context.js';
 
@@ -293,7 +293,7 @@ export function nativeSessionConfig(
       ...(targets.length || parentAgent ? [SEND_TOOL] : []),
       ...(parentAgent ? [HANDOFF_TOOL] : []),
       ...(supervised ? [LESSON_TOOL, SKILL_TOOL] : []),
-      ...(!parentAgent && mapping.agent.name === mainOf(mapping) ? [ISSUE_TOOL] : []),
+      ...(!parentAgent && mapping.agent.name === mainOf(mapping) ? [ISSUE_TOOL, SCHEDULE_TOOL] : []),
       ASK_TOOL,
       PIN_TOOL,
       BOARD_TOOL,

package/src/session-state.ts

@@ -1,4 +1,4 @@
-import type { RuntimeTransport } from './contracts.js';
+import type { NativeBase, RuntimeTransport } from './contracts.js';
 import type { RuntimeKind, SessionSpec, ResolvedSession } from './resolve.js';
 import type { MailEvent } from './mailbox.js';
 import type { Worktree, WorktreeChange, Copy } from './workspace.js';
@@ -6,11 +6,17 @@ import type { Verification } from '@anhlp/alp-core/verify';
 import type { Handoff } from './handoff.js';
 import type { SessionUsage } from './events.js';
 
+/** The pause that stopped a turn; a matching resume may arrive before its interruption settles. */
+export type ParkPause = { scope: RuntimeKind | 'all'; resumed?: boolean };
+export type Parked = { reason: string; since: number; prompt?: string; pause?: ParkPause };
+
 export type Session = {
   runtimeKind: RuntimeKind;
   runtime: RuntimeTransport;
   mapping: ResolvedSession;
   threadId: string;
+  /** Claude: the conversation threadId is made from on its first prompt, until then (a fork or rewind, §12.7). */
+  base?: NativeBase;
   active?: string;
   /** A continued turn accepts a simultaneous user auto prompt as steering. */
   resumedTurn?: string;
@@ -51,7 +57,7 @@ export type Session = {
   /** Set by interrupt: pending mail waits for the next user prompt. */
   wakeBlocked: boolean;
   /** An assignment a usage limit or a pause stopped: it waits, open, until its runtime resumes. prompt is what continues it. */
-  parked?: { reason: string; since: number; prompt?: string };
+  parked?: Parked;
   /** What the requester of a session parked by its turn's end is told happens next, instead of waiting for alp resume. */
   parkThen?: string;
   /** When ALP restarted this session's native process, within the last RESTART_WINDOW_MS. */
@@ -70,8 +76,15 @@ export type Session = {
   skillsUsed?: Set<string>;
   /** Why the running turn is being stopped, so its end parks the assignment instead of ending it. */
   parkReason?: string;
+  parkPause?: ParkPause;
   /** Mail arrived while its runtime was paused; it is delivered on resume. */
   wakeHeld?: boolean;
+  /** How many lifecycle operations (a rewind) hold its wakes now; mail waits until the last releases (AlpRuntime.hold). */
+  lifecycleHolds?: number;
+  /** Its parked work was to continue during a lifecycle hold; it continues when the last hold releases. */
+  resumeHeld?: Parked;
+  /** An assignment opened but not yet sent its brief: mail waits and rides with the brief's turn. */
+  awaitingBrief?: boolean;
   /** Permission questions to the user, one at a time. */
   permissionQueue?: Promise<unknown>;
 

package/src/tools.ts

@@ -379,3 +379,19 @@ export function taskBrief(task: Task, writing: boolean) {
     'Your handoff moves this task to review for your requester to accept. List work you found outside the task under discovered; only main and the user create tasks.',
   ].join('\n');
 }
+
+/** Only the project's main root may schedule a future continuation. */
+export const SCHEDULE_TOOL = {
+  type: 'function', name: 'alp_schedule',
+  description: 'Create, list, inspect or cancel a one-shot continuation of this main/root session. create proposes the exact prompt and ISO time with UTC offset for user approval. Jobs wake an idle main without a user message; timer gates only unblock tasks, and assignment notes do not schedule a wake. Scheduling a quota-reset continuation never guarantees provider availability: recheck actual availability before delegating.',
+  inputSchema: {
+    type: 'object', properties: {
+      action: { type: 'string', enum: ['create', 'list', 'get', 'cancel'] },
+      dueAt: { type: 'string', description: 'For create: ISO timestamp with Z or an explicit UTC offset.' },
+      prompt: { type: 'string', description: 'For create: the exact continuation, at most 8000 characters.' },
+      requestId: { type: 'string', description: 'For create: stable id for this approval proposal; reuse only for an identical draft.' },
+      id: { type: 'string', description: 'For get/cancel: the scheduled job id.' },
+      status: { type: 'string', enum: ['pending', 'delivered', 'failed', 'cancelled'] },
+    }, required: ['action'], additionalProperties: false,
+  },
+};

package/src/worktree-domain.ts

@@ -12,6 +12,7 @@ import type { Session, Assignment } from './session-state.js';
 
 type WorktreeContext = {
   options: RuntimeOptions;
+  releaseResult(assignmentId: string): Promise<void>;
   leases: Map<string, { assignment: string; agent: string }>;
   rootOf(sessionId: string): string;
   lineage(sessionId: string): string[];
@@ -21,7 +22,7 @@ type WorktreeContext = {
 };
 
 /** Checkout mutation and verification retain one shared queue per checkout. */
-export function createWorktreeDomain({ options, leases, rootOf, lineage, runLog, runHooks, touchTask }: WorktreeContext) {
+export function createWorktreeDomain({ options, leases, releaseResult, rootOf, lineage, runLog, runHooks, touchTask }: WorktreeContext) {
   const merging = new Map<string, Promise<unknown>>();
 
   /** Commits a finished isolated assignment's work and keeps it for the requester to merge. */
@@ -31,6 +32,7 @@ export function createWorktreeDomain({ options, leases, rootOf, lineage, runLog,
       const change = await commitWorktree(worktree, `alp: ${assignment.agent} assignment ${assignment.id}`);
       if (!change.files.length) {
         await removeWorktree(worktree, { deleteBranch: true });
+        await releaseResult(assignment.id);
         return { branch: worktree.branch, files: [], note: 'No changes; the worktree was removed' };
       }
       const described = { branch: worktree.branch, base: worktree.base, commit: change.commit, files: change.files, stat: change.stat };
@@ -60,6 +62,7 @@ export function createWorktreeDomain({ options, leases, rootOf, lineage, runLog,
     if (action === 'discard') {
       session.worktrees.delete(args.assignmentId);
       await removeWorktree(worktree, { deleteBranch: true });
+      await releaseResult(args.assignmentId);
       runLog(rootOf(sessionId), { event: 'worktree.discarded', assignmentId: args.assignmentId, branch: worktree.branch });
       return toolResult(true, { discarded: args.assignmentId, branch: worktree.branch });
     }
@@ -122,6 +125,7 @@ export function createWorktreeDomain({ options, leases, rootOf, lineage, runLog,
     }
     // A conflicted change keeps its branch for reference.
     await removeWorktree(worktree, { deleteBranch: merged.status !== 'conflicts' });
+    if (merged.status !== 'conflicts') await releaseResult(args.assignmentId);
     runLog(rootId, { event: 'worktree.merged', assignmentId: args.assignmentId, branch: worktree.branch, ...merged });
     // The checkout changed since the assignment started, so the worktree's check says little about the result: check the checkout too.
     let checked: Verification | undefined;