@yansirplus/cli 0.5.18 → 0.5.20

package/dist/build/agent-authoring/static-target.js

@@ -302,10 +302,12 @@ const renderScheduleRegistry = (schedules, modules) => {
             .map((schedule, index) => `  { scheduleId: ${jsString(schedule.scheduleId)}, path: ${jsString(schedule.path)}, cron: ${jsString(schedule.cron)}, schedule: schedule_${index} as DefinedSchedule },`)
             .join("\n")}\n]`;
     return `${scheduleImports}
-${renderNamedImport(["dispatchScheduleFire"], modules.runtimeSchedule)}
+${renderNamedImport(["dispatchScheduleFire", "dispatchScheduleFireDelivery"], modules.runtimeSchedule)}
 ${renderTypeImport([
         "DefinedSchedule",
         "ScheduleDefinitionProjection",
+        "ScheduleFireDeliveryDispatchInput",
+        "ScheduleFireDeliveryDispatchResult",
         "ScheduleFireDispatchResult",
         "SchedulePrincipal",
         "ScheduleRuntime",
@@ -330,6 +332,10 @@ export type GeneratedScheduleDispatchInput = GeneratedScheduleTriggerInput & {
   readonly identity: LedgerTruthIdentity;
 };
 
+export type GeneratedScheduleDeliveryDispatchInput = GeneratedScheduleDispatchInput & {
+  readonly history: ScheduleFireDeliveryDispatchInput["history"];
+};
+
 export const generatedSchedules = ${entries} as const satisfies ReadonlyArray<GeneratedScheduleDefinition>;
 export const generatedScheduleDefinitions = generatedSchedules.map(
   ({ scheduleId, path, cron }) => ({ scheduleId, path, cron }),
@@ -356,6 +362,25 @@ export const dispatchGeneratedSchedule = async (
     effectAuthorityRef: input.identity.effectAuthorityRef,
   });
 };
+
+export const dispatchGeneratedScheduleDelivery = async (
+  input: GeneratedScheduleDeliveryDispatchInput,
+): Promise<ScheduleFireDeliveryDispatchResult> => {
+  const entry = generatedScheduleRegistry.get(input.scheduleId);
+  if (entry === undefined) {
+    throw new Error(\`unknown generated schedule: \${input.scheduleId}\`);
+  }
+  return dispatchScheduleFireDelivery({
+    history: input.history,
+    runtime: input.runtime,
+    schedule: entry.schedule,
+    scheduleId: entry.scheduleId,
+    appPrincipal: input.appPrincipal,
+    scheduledAt: input.scheduledAt,
+    scopeRef: input.identity.scopeRef,
+    effectAuthorityRef: input.identity.effectAuthorityRef,
+  });
+};
 `;
 };
 const renderSkillCatalog = (skills) => {
@@ -439,11 +464,13 @@ const generatedDynamicCapabilityTurnEvent = (
 
 const generatedDynamicSubmitBindingsFor = async (
   event: DynamicCapabilityEventRef,
+  input: DynamicCapabilityRunInput | undefined = undefined,
 ): Promise<GeneratedTargetResult<Pick<AgentSubmitBindings, "dynamicCapabilityProjection" | "instructionFragments">>> => {
   const projection = await runDynamicCapabilityResolvers({
     event,
     catalog: generatedDynamicCapabilityCatalog,
     resolvers: generatedDynamicCapabilityResolvers,
+    input,
     materials: semanticManifest.materials ?? {},
   });
   if (!projection.ok) {
@@ -602,6 +629,7 @@ const renderSubmitSpecFromRunInput = (hasSkills) => `const submitSpecFromRunInpu
   ...(input.budget === undefined ? {} : { budget: input.budget }),
   ...(input.outputSchema === undefined ? {} : { outputSchema: input.outputSchema }),
   ...(input.traceContext === undefined ? {} : { traceContext: input.traceContext }),
+  ...(input.dynamicCapability === undefined ? {} : { dynamicCapability: input.dynamicCapability }),
   ...(input.materials === undefined ? {} : { materials: input.materials }),
   ...(input.toolContext === undefined ? {} : { toolContext: input.toolContext }),
   ...(input.toolPolicy === undefined ? {} : { toolPolicy: input.toolPolicy }),
@@ -633,6 +661,7 @@ const submitRunInputFields = (input: SubmitRunInput): SubmitRunInput => ({
   ...(input.budget === undefined ? {} : { budget: input.budget }),
   ...(input.outputSchema === undefined ? {} : { outputSchema: input.outputSchema }),
   ...(input.traceContext === undefined ? {} : { traceContext: input.traceContext }),
+  ...(input.dynamicCapability === undefined ? {} : { dynamicCapability: input.dynamicCapability }),
   ...(input.materials === undefined ? {} : { materials: input.materials }),
   ...(input.toolContext === undefined ? {} : { toolContext: input.toolContext }),
   ...(input.toolPolicy === undefined ? {} : { toolPolicy: input.toolPolicy }),
@@ -655,6 +684,7 @@ const renderProductApiDurableObjectMethods = () => `
         sessionRef: input.sessionRef,
         turnRef: input.turnRef,
       }),
+      input.dynamicCapability,
     ).then((bindings) =>
       bindings.ok
         ? this.submitWithBindingsAndProductLink(
@@ -685,7 +715,11 @@ const renderProductApiDurableObjectMethods = () => `
   }
 
   runWorkflow(input: AgentWorkflowRunInput): Promise<SubmitResult> {
-    return generatedSubmitBindingsFor(this.targetEnv).then((bindings) =>
+    return generatedSubmitBindingsFor(
+      this.targetEnv,
+      generatedDynamicCapabilityTurnEvent(),
+      input.dynamicCapability,
+    ).then((bindings) =>
       bindings.ok
         ? this.submitWithBindingsAndProductLink(
             submitSpecFromRunInput(
@@ -731,11 +765,14 @@ const generatedScheduleRuntimeFor = (target: {
   });`;
 const renderScheduleDurableObjectMethod = () => `
   dispatchSchedule(input: GeneratedScheduleTriggerInput): Promise<unknown> {
-    return dispatchGeneratedSchedule({
-      ...input,
-      identity: semanticTruthIdentity,
-      runtime: generatedScheduleRuntimeFor(this),
-    }).then((result) => this.commitScheduleFireDispatchFull(result));
+    return this.events(semanticTruthIdentity).then((history) =>
+      dispatchGeneratedScheduleDelivery({
+        ...input,
+        history,
+        identity: semanticTruthIdentity,
+        runtime: generatedScheduleRuntimeFor(this),
+      }).then((result) => this.commitScheduleFireDispatchFullWithDelivery(result)),
+    );
   }
 `;
 const renderGeneratedWorkspaceOperations = (workspaceToolArray, usesMutationTools, usesShellTools) => `const generatedWorkspaceToolNames = ${workspaceToolArray};
@@ -787,7 +824,9 @@ const renderWorkspaceStaticTarget = (normalized, toolNames, modules) => {
     const imports = [
         `import semanticDeclarations from "./manifest.json";`,
         `import deploymentProvenance from "./deployment.json";`,
-        ...(hasSchedules ? [renderNamedImport(["dispatchGeneratedSchedule"], "./schedules")] : []),
+        ...(hasSchedules
+            ? [renderNamedImport(["dispatchGeneratedScheduleDelivery"], "./schedules")]
+            : []),
         renderNamedImport(["createAgentDurableObject"], modules.cloudflareDoRuntime),
         renderNamedImport([
             "WORKSPACE_OPERATION_HOST_FACT",
@@ -815,6 +854,7 @@ const renderWorkspaceStaticTarget = (normalized, toolNames, modules) => {
                     "DynamicCapabilityCompiledCatalog",
                     "DynamicCapabilityEventRef",
                     "DynamicCapabilityProjection",
+                    "DynamicCapabilityRunInput",
                     "SubmitInstructionFragment",
                 ], modules.runtimeProtocol),
                 renderTypeImport(["DynamicCapabilityResolverDefinition"], modules.runtimeCapability),
@@ -1020,6 +1060,7 @@ ${renderGeneratedLlmRoutesFor(normalized.llmRoutes)}
 const generatedSubmitBindingsFor = async (
   env: AgentOSTargetEnv,
   event: DynamicCapabilityEventRef = generatedDynamicCapabilityTurnEvent(),
+  dynamicCapability: DynamicCapabilityRunInput | undefined = undefined,
 ): Promise<GeneratedTargetResult<AgentSubmitBindings>> => {
   const preflightDiagnostics = generatedProviderPreflightDiagnosticsFor(env);
   if (preflightDiagnostics.length > 0) {
@@ -1031,7 +1072,7 @@ const generatedSubmitBindingsFor = async (
   const capabilityGraph = generatedCapabilityInstallGraphFor(env);
   const routes = generatedLlmRoutesFor(env);
   if (!routes.ok) return routes;
-  const dynamicBindings = await generatedDynamicSubmitBindingsFor(event);
+  const dynamicBindings = await generatedDynamicSubmitBindingsFor(event, dynamicCapability);
   if (!dynamicBindings.ok) return dynamicBindings;
   const dynamicCapabilityProjection = dynamicBindings.value.dynamicCapabilityProjection;
   return {
@@ -1091,13 +1132,21 @@ export class ${target.durableObject.className} extends Base${target.durableObjec
   }
 
   override submit(spec: AgentSubmitSpec): Promise<SubmitResult> {
-    return generatedSubmitBindingsFor(this.targetEnv).then((bindings) =>
+    return generatedSubmitBindingsFor(
+      this.targetEnv,
+      generatedDynamicCapabilityTurnEvent(),
+      spec.dynamicCapability,
+    ).then((bindings) =>
       bindings.ok ? this.submitWithBindings(spec, bindings.value) : rejectTargetFailure(bindings),
     );
   }
 
   submitRunInput(input: SubmitRunInput): Promise<SubmitResult> {
-    return generatedSubmitBindingsFor(this.targetEnv).then((bindings) =>
+    return generatedSubmitBindingsFor(
+      this.targetEnv,
+      generatedDynamicCapabilityTurnEvent(),
+      input.dynamicCapability,
+    ).then((bindings) =>
       bindings.ok
         ? this.submitWithBindings(
             submitSpecFromRunInput(input, bindings.value.dynamicCapabilityProjection),
@@ -1215,7 +1264,9 @@ const renderChatStaticTarget = (normalized, toolNames, modules) => {
     const imports = [
         `import semanticDeclarations from "./manifest.json";`,
         `import deploymentProvenance from "./deployment.json";`,
-        ...(hasSchedules ? [renderNamedImport(["dispatchGeneratedSchedule"], "./schedules")] : []),
+        ...(hasSchedules
+            ? [renderNamedImport(["dispatchGeneratedScheduleDelivery"], "./schedules")]
+            : []),
         renderNamedImport(["createAgentDurableObject"], modules.cloudflareDoRuntime),
         renderNamedImport(["runDynamicCapabilityResolvers"], modules.runtimeCapability),
         renderNamedImport(["OpenAiCompatibleLlmTransportLive", "preflightOpenAiCompatibleProviderMaterial"], modules.openAiCompatibleTransport),
@@ -1234,6 +1285,7 @@ const renderChatStaticTarget = (normalized, toolNames, modules) => {
                     "DynamicCapabilityCompiledCatalog",
                     "DynamicCapabilityEventRef",
                     "DynamicCapabilityProjection",
+                    "DynamicCapabilityRunInput",
                     "SubmitInstructionFragment",
                 ], modules.runtimeProtocol),
                 renderTypeImport(["DynamicCapabilityResolverDefinition"], modules.runtimeCapability),
@@ -1322,6 +1374,7 @@ ${renderGeneratedLlmRoutesFor(normalized.llmRoutes)}
 const generatedSubmitBindingsFor = async (
   env: AgentOSTargetEnv,
   event: DynamicCapabilityEventRef = generatedDynamicCapabilityTurnEvent(),
+  dynamicCapability: DynamicCapabilityRunInput | undefined = undefined,
 ): Promise<GeneratedTargetResult<AgentSubmitBindings>> => {
   const preflightDiagnostics = generatedProviderPreflightDiagnosticsFor(env);
   if (preflightDiagnostics.length > 0) {
@@ -1332,7 +1385,7 @@ const generatedSubmitBindingsFor = async (
   }
   const routes = generatedLlmRoutesFor(env);
   if (!routes.ok) return routes;
-  const dynamicBindings = await generatedDynamicSubmitBindingsFor(event);
+  const dynamicBindings = await generatedDynamicSubmitBindingsFor(event, dynamicCapability);
   if (!dynamicBindings.ok) return dynamicBindings;
   const dynamicCapabilityProjection = dynamicBindings.value.dynamicCapabilityProjection;
   return {
@@ -1375,13 +1428,21 @@ export class ${target.durableObject.className} extends Base${target.durableObjec
   }
 
   override submit(spec: AgentSubmitSpec): Promise<SubmitResult> {
-    return generatedSubmitBindingsFor(this.targetEnv).then((bindings) =>
+    return generatedSubmitBindingsFor(
+      this.targetEnv,
+      generatedDynamicCapabilityTurnEvent(),
+      spec.dynamicCapability,
+    ).then((bindings) =>
       bindings.ok ? this.submitWithBindings(spec, bindings.value) : rejectTargetFailure(bindings),
     );
   }
 
   submitRunInput(input: SubmitRunInput): Promise<SubmitResult> {
-    return generatedSubmitBindingsFor(this.targetEnv).then((bindings) =>
+    return generatedSubmitBindingsFor(
+      this.targetEnv,
+      generatedDynamicCapabilityTurnEvent(),
+      input.dynamicCapability,
+    ).then((bindings) =>
       bindings.ok
         ? this.submitWithBindings(
             submitSpecFromRunInput(input, bindings.value.dynamicCapabilityProjection),
@@ -1449,7 +1510,11 @@ const renderLocalAgentApp = (normalized, toolNames, modules) => {
         ...(hasChannels ? [renderTypeImport(["ChannelRuntime"], modules.runtimeChannel)] : []),
         ...(hasSchedules
             ? [
-                renderNamedImport(["dispatchGeneratedSchedule", "generatedScheduleDefinitions", "generatedScheduleIds"], "./schedules"),
+                renderNamedImport([
+                    "dispatchGeneratedScheduleDelivery",
+                    "generatedScheduleDefinitions",
+                    "generatedScheduleIds",
+                ], "./schedules"),
             ]
             : []),
         ...(hasSchedules ? [renderTypeImport(["GeneratedScheduleTriggerInput"], "./schedules")] : []),
@@ -1460,13 +1525,20 @@ const renderLocalAgentApp = (normalized, toolNames, modules) => {
             : []),
         renderNamedImport(["DYNAMIC_CAPABILITY_EVENT", "manifestTruthIdentity"], modules.runtimeProtocol),
         renderNamedImport(["OpenAiCompatibleLlmTransportLive", "preflightOpenAiCompatibleProviderMaterial"], modules.openAiCompatibleTransport),
-        renderNamedImport(["projectAgentSession", "projectAgentSessions", "projectWorkflowRun", "projectWorkflowRuns"], modules.runtimeRunProjector),
+        renderNamedImport([
+            "projectAgentSession",
+            "projectAgentSessions",
+            "projectRunInspection",
+            "projectWorkflowRun",
+            "projectWorkflowRuns",
+        ], modules.runtimeRunProjector),
         renderTypeImport(["AgentManifest", "SubmitResult", "SubmitRunInput"], modules.runtimeProtocol),
         renderTypeImport([
             "AgentSubmitBindings",
             "DynamicCapabilityCompiledCatalog",
             "DynamicCapabilityEventRef",
             "DynamicCapabilityProjection",
+            "DynamicCapabilityRunInput",
             "SubmitInstructionFragment",
         ], modules.runtimeProtocol),
         renderTypeImport(["DynamicCapabilityResolverDefinition"], modules.runtimeCapability),
@@ -1482,6 +1554,7 @@ const renderLocalAgentApp = (normalized, toolNames, modules) => {
         renderTypeImport([
             "AgentSessionListProjection",
             "AgentSessionProjection",
+            "RunInspection",
             "WorkflowRunListProjection",
             "WorkflowRunProjection",
         ], modules.runtimeRunProjector),
@@ -1587,7 +1660,7 @@ const generatedLocalSubmitInputFromRunInput = async (
   input: SubmitRunInput,
   event: DynamicCapabilityEventRef = generatedDynamicCapabilityTurnEvent(),
 ): Promise<LocalAgentSubmitInput> => {
-  const dynamicBindings = await generatedDynamicSubmitBindingsFor(event);
+  const dynamicBindings = await generatedDynamicSubmitBindingsFor(event, input.dynamicCapability);
   if (!dynamicBindings.ok) return rejectTargetFailure(dynamicBindings);
   const dynamicCapabilityProjection = dynamicBindings.value.dynamicCapabilityProjection;
   return {
@@ -1607,8 +1680,12 @@ const generatedLocalSubmitInputFromRunInput = async (
   };
 };
 
+export interface LocalAgentAppRuntime extends LocalAgentRuntime {
+  readonly inspectRun: (runId: number | string) => RunInspection;
+}
+
 export interface LocalAgentApp {
-  readonly runtime: LocalAgentRuntime;
+  readonly runtime: LocalAgentAppRuntime;
   readonly sessions: {
     readonly submitTurn: (input: AgentSessionSubmitTurnInput) => Promise<SubmitResult>;
     readonly inspect: (sessionRef: string) => AgentSessionProjection;
@@ -1701,6 +1778,11 @@ export const createLocalAgentApp = async (
       projectWorkflowRun(lowered.runtime.events(), workflowId, workflowRunId),
     listRuns: (workflowId: string) => projectWorkflowRuns(lowered.runtime.events(), workflowId),
   };
+  const runtime: LocalAgentAppRuntime = {
+    ...lowered.runtime,
+    inspectRun: (runId) =>
+      projectRunInspection(lowered.runtime.events(), runId, lowered.runtime.diagnostics()),
+  };
   ${hasChannels
         ? `const channelRuntime: ChannelRuntime = {
     submit: (input) => lowered.runtime.submit(input),
@@ -1726,12 +1808,15 @@ export const createLocalAgentApp = async (
   const triggerSchedule = async (
     input: GeneratedScheduleTriggerInput,
   ): Promise<ScheduleFireProjection> => {
-    const result = await dispatchGeneratedSchedule({
+    const result = await dispatchGeneratedScheduleDelivery({
       ...input,
+      history: lowered.runtime.events(),
       identity: semanticTruthIdentity,
       runtime: { sessions, workflows },
     });
-    await lowered.commitScheduleFireDispatch(result);
+    if (result.kind === "attempt") {
+      await lowered.commitScheduleFireDispatchWithDelivery(result);
+    }
     const projected = scheduleHistory({ scheduleId: input.scheduleId }).fires.find(
       (fire) => fire.fireId === result.fireId,
     );
@@ -1742,7 +1827,7 @@ export const createLocalAgentApp = async (
   };`
         : ""}
   return {
-    runtime: lowered.runtime,
+    runtime,
     sessions,
     workflows,
     ${hasChannels ? "channels,\n    " : ""}customCommand,
@@ -3083,6 +3168,17 @@ export const linkWorkspaceStaticTarget = (normalized, options = {}) => {
                 source: modules.workspaceAgentHost,
                 imports: ["WorkspaceAgentCustomCommandInput"],
             },
+            {
+                kind: "target-runtime",
+                source: modules.runtimeRunProjector,
+                imports: [
+                    "projectAgentSession",
+                    "projectAgentSessions",
+                    "projectRunInspection",
+                    "projectWorkflowRun",
+                    "projectWorkflowRuns",
+                ],
+            },
             ...generatedToolImports(authoredManifestToolNames),
             ...generatedDynamicResolverImports(normalized.dynamicResolvers),
             ...(hasChannels
@@ -3113,6 +3209,7 @@ export const linkWorkspaceStaticTarget = (normalized, options = {}) => {
                         source: "./schedules",
                         imports: [
                             "dispatchGeneratedSchedule",
+                            "dispatchGeneratedScheduleDelivery",
                             "generatedScheduleDefinitions",
                             "generatedSchedules",
                         ],
@@ -3230,6 +3327,7 @@ export const linkWorkspaceStaticTarget = (normalized, options = {}) => {
                     source: "./schedules",
                     imports: [
                         "dispatchGeneratedSchedule",
+                        "dispatchGeneratedScheduleDelivery",
                         "generatedScheduleDefinitions",
                         "generatedSchedules",
                     ],

package/dist/build/build-cli.js

@@ -926,6 +926,9 @@ const PRODUCT_COMMAND = {
     INSPECT_WORKFLOW_RUN: "inspectWorkflowRun",
     LIST_WORKFLOW_RUNS: "listWorkflowRuns",
 };
+const RUNTIME_COMMAND = {
+    INSPECT_RUN: "inspectRuntimeRun",
+};
 class HttpFailure extends Error {
     status;
     constructor(status, message) {
@@ -1047,6 +1050,18 @@ const invokeLocalAgentCommand = async (app, request) => {
         const record = commandInputRecord(input, "submit");
         return app.runtime.submit(assertSubmitRunInput(record.input, "submit"));
     }
+    if (name === RUNTIME_COMMAND.INSPECT_RUN) {
+        if (app.runtime.inspectRun === undefined) {
+            throw new HttpFailure(501, "runtime run inspection is unavailable");
+        }
+        const record = commandInputRecord(input, "inspectRuntimeRun");
+        const rawRunId = record.runId;
+        if (!((typeof rawRunId === "number" && Number.isInteger(rawRunId) && rawRunId >= 1) ||
+            (typeof rawRunId === "string" && rawRunId.length > 0))) {
+            throw new HttpFailure(400, "invalid runtime run identity");
+        }
+        return app.runtime.inspectRun(rawRunId);
+    }
     if (name === PRODUCT_COMMAND.SUBMIT_SESSION_TURN) {
         if (app.sessions === undefined)
             throw new HttpFailure(501, "sessions are unavailable");