@ahmadposten/talos-wire 0.1.1 → 0.1.3

package/dist/index.cjs

@@ -366,6 +366,170 @@ const ProviderUsageSnapshotSchema = z__namespace.object({
   retryAt: z__namespace.number().finite().optional()
 });
 
+const text = z.z.string().trim().min(1).max(24e3);
+const WorkflowAgentSchema = z.z.object({
+  id: z.z.string().min(1).max(100),
+  revision: z.z.number().int().positive(),
+  name: z.z.string().min(1).max(60),
+  description: z.z.string().max(300),
+  provider: z.z.literal("codex"),
+  model: z.z.string().min(1).max(200),
+  effort: z.z.string().max(30).nullable(),
+  permissionMode: z.z.enum(["default", "read-only"]),
+  instructions: text,
+  documents: z.z.array(z.z.object({ name: z.z.string().max(120), content: z.z.string().max(16e3) })).max(5)
+});
+const WorkflowSlotSchema = z.z.object({ agent: WorkflowAgentSchema, assignment: text });
+const WorkflowStepSchema = z.z.object({
+  id: z.z.string().uuid(),
+  name: z.z.string().trim().min(1).max(80),
+  kind: z.z.enum(["plan", "execute", "review"]),
+  agents: z.z.array(WorkflowSlotSchema).min(1).max(3),
+  criteria: z.z.string().trim().max(24e3),
+  checks: z.z.array(z.z.object({ name: z.z.string().trim().min(1).max(100), command: z.z.string().trim().min(1).max(2e3) })).max(8)
+});
+function workflowProjection(steps) {
+  return {
+    planners: steps.find((s) => s.kind === "plan")?.agents ?? [],
+    executor: steps.find((s) => s.kind === "execute")?.agents[0],
+    reviewers: [...steps].reverse().find((s) => s.kind === "review")?.agents ?? []
+  };
+}
+const WorkflowDefinitionSchema = z.z.object({
+  id: z.z.string().uuid(),
+  revision: z.z.number().int().positive(),
+  name: z.z.string().trim().min(1).max(80),
+  description: z.z.string().max(1e3),
+  planners: z.z.array(WorkflowSlotSchema).min(1).max(4),
+  executor: WorkflowSlotSchema,
+  reviewers: z.z.array(WorkflowSlotSchema).min(1).max(4),
+  steps: z.z.array(WorkflowStepSchema).min(3).max(8).optional(),
+  criteria: text,
+  checks: z.z.array(z.z.object({ name: z.z.string().trim().min(1).max(100), command: z.z.string().trim().min(1).max(2e3) })).min(1).max(8),
+  planningRounds: z.z.number().int().min(1).max(5),
+  reviewRounds: z.z.number().int().min(1).max(5),
+  turnMinutes: z.z.number().int().min(1).max(30),
+  maxTurns: z.z.number().int().min(8).max(100),
+  approvePlan: z.z.boolean(),
+  updatedAt: z.z.number()
+}).superRefine((d, ctx) => {
+  if (new TextEncoder().encode(JSON.stringify(d)).length > 64e3) ctx.addIssue({ code: "custom", message: "Workflow definition exceeds 64 KB. Shorten instructions or documents." });
+  const issue = (message) => ctx.addIssue({ code: "custom", message });
+  if (d.steps) {
+    if (d.steps[0].kind !== "plan" || d.steps.at(-1)?.kind !== "review" || !d.steps.some((s) => s.kind === "execute")) issue("Start with planning, include execution, and finish with review.");
+    if (new Set(d.steps.map((s) => s.id)).size !== d.steps.length) issue("Each step needs a unique ID.");
+    const writers = new Set(d.steps.filter((s) => s.kind === "execute").flatMap((s) => s.agents.map((a) => a.agent.id)));
+    const identities = /* @__PURE__ */ new Map();
+    let executed = false;
+    for (const step of d.steps) {
+      if (step.kind === "plan") executed = false;
+      if (step.kind === "execute") executed = true;
+      if (step.kind === "review" && !executed) issue("Place an execution step between planning and review.");
+      if (step.kind === "execute" && (step.agents.length !== 1 || step.agents[0].agent.permissionMode === "read-only")) issue("Each execution step needs one agent that allows workspace edits.");
+      if (step.kind !== "review" && step.checks.length) issue("Attach step checks to a review step.");
+      if (new Set(step.agents.map((s) => s.agent.id)).size !== step.agents.length) issue("Choose distinct agents within a consensus step.");
+      for (const slot of step.agents) {
+        if (step.kind === "review" && writers.has(slot.agent.id)) issue("Reviewers must be independent of every executor.");
+        const snapshot = JSON.stringify(slot.agent);
+        if (identities.has(slot.agent.id) && identities.get(slot.agent.id) !== snapshot) issue("A reused agent must have the same configuration in every step.");
+        identities.set(slot.agent.id, snapshot);
+      }
+    }
+    const projection = workflowProjection(d.steps);
+    if (JSON.stringify([d.planners, d.executor, d.reviewers]) !== JSON.stringify([projection.planners, projection.executor, projection.reviewers])) issue("Workflow role summaries must match its steps.");
+  } else {
+    if (d.planners.length < 2 || d.reviewers.length < 2) issue("Legacy workflows require at least two planners and reviewers.");
+    const ids = [...d.planners, d.executor, ...d.reviewers].map((s) => s.agent.id);
+    if (new Set(ids).size !== ids.length) issue("Each workflow participant must be a different saved agent.");
+    if (d.executor.agent.permissionMode === "read-only") issue("The executor must allow workspace edits.");
+  }
+});
+const WorkflowLibrarySchema = z.z.array(WorkflowDefinitionSchema).max(20).refine((x) => JSON.stringify(x).length < 128e3, "Workflow library is too large.");
+function workflowSlots(d) {
+  return d.steps?.flatMap((s) => s.agents) ?? [...d.planners, d.executor, ...d.reviewers];
+}
+const WorkflowStageSchema = z.z.enum(["propose", "consolidate", "plan_vote", "execute", "review", "verify"]);
+const WorkflowDecisionSchema = z.z.object({
+  decision: z.z.enum(["approve", "changes", "information", "replan"]),
+  summary: text,
+  document: z.z.string().max(24e3),
+  findings: z.z.array(z.z.object({ title: z.z.string().min(1).max(300), evidence: text, correction: text, blocking: z.z.boolean() })).max(20)
+});
+const WorkflowTaskSchema = z.z.object({
+  id: z.z.string(),
+  stage: WorkflowStageSchema,
+  round: z.z.number(),
+  agentId: z.z.string(),
+  agentName: z.z.string(),
+  stepId: z.z.string().uuid().optional(),
+  attempt: z.z.number().int().positive().optional(),
+  clarifications: z.z.number().int().optional(),
+  assignment: z.z.string(),
+  version: z.z.string(),
+  status: z.z.enum(["running", "done", "interrupted"]),
+  startedAt: z.z.number(),
+  completedAt: z.z.number().optional(),
+  sessionId: z.z.string().optional(),
+  threadId: z.z.string().optional(),
+  prompt: z.z.string(),
+  result: WorkflowDecisionSchema.optional(),
+  error: z.z.string().optional()
+});
+const WorkflowRunSchema = z.z.object({
+  id: z.z.string().uuid(),
+  revision: z.z.number().int(),
+  definition: WorkflowDefinitionSchema,
+  machineId: z.z.string(),
+  task: text,
+  requestedDirectory: z.z.string().optional(),
+  sourceDirectory: z.z.string(),
+  directory: z.z.string(),
+  branch: z.z.string(),
+  baseCommit: z.z.string(),
+  status: z.z.enum(["running", "paused", "needs_input", "complete", "cancelled"]),
+  stage: WorkflowStageSchema,
+  stepIndex: z.z.number().int().nonnegative().optional(),
+  stepAttempt: z.z.number().int().positive().optional(),
+  stepRounds: z.z.record(z.z.string(), z.z.number().int().positive()).optional(),
+  completedSteps: z.z.array(z.z.string().uuid()).max(8).optional(),
+  planningRound: z.z.number().int(),
+  reviewRound: z.z.number().int(),
+  planVersion: z.z.number().int(),
+  plan: z.z.string(),
+  artifactVersion: z.z.string(),
+  reason: z.z.string(),
+  tasks: z.z.array(WorkflowTaskSchema).max(200),
+  checks: z.z.array(z.z.object({ name: z.z.string(), exitCode: z.z.number().nullable(), output: z.z.string(), version: z.z.string() })),
+  events: z.z.array(z.z.object({ at: z.z.number(), text: z.z.string() })).max(500),
+  notes: z.z.array(z.z.string()).max(30),
+  approvedPlanVersion: z.z.number().nullable(),
+  createdAt: z.z.number(),
+  updatedAt: z.z.number()
+}).superRefine((run, ctx) => {
+  if (!run.definition.steps) return;
+  const steps = run.definition.steps;
+  const step = steps[run.stepIndex ?? -1];
+  if (!step || !run.stepAttempt || !run.completedSteps || !run.stepRounds) {
+    ctx.addIssue({ code: "custom", message: "Editable workflow recovery state is incomplete." });
+    return;
+  }
+  const stages = step.kind === "plan" ? ["propose", "consolidate", "plan_vote"] : step.kind === "execute" ? ["execute"] : ["verify", "review"];
+  if (!stages.includes(run.stage) || run.completedSteps.some((id) => !steps.some((s) => s.id === id)) || run.tasks.some((t) => !t.stepId || !t.attempt || !steps.some((s) => s.id === t.stepId))) ctx.addIssue({ code: "custom", message: "Saved workflow stage does not match its definition." });
+});
+const WorkflowStartSchema = z.z.object({ id: z.z.string().uuid(), definition: WorkflowDefinitionSchema, task: text, directory: z.z.string().min(1).max(4e3) });
+const WorkflowActionSchema = z.z.object({
+  id: z.z.string().uuid(),
+  expectedRevision: z.z.number().int(),
+  action: z.z.enum(["pause", "resume", "cancel", "approve_plan", "revise_plan", "retry_review", "replace_agent"]),
+  note: z.z.string().trim().max(24e3).default(""),
+  agentId: z.z.string().optional(),
+  replacement: WorkflowAgentSchema.optional()
+});
+function workflowEnabled(s) {
+  return s.experiments === true && s.expWorkflows === true;
+}
+const workflowStageLabel = { propose: "Independent proposals", consolidate: "Consolidating plan", plan_vote: "Planning consensus", execute: "Executing", review: "Independent review", verify: "Completion checks" };
+
 exports.AgentMessageSchema = AgentMessageSchema;
 exports.ApiMessageSchema = ApiMessageSchema;
 exports.ApiUpdateMachineStateSchema = ApiUpdateMachineStateSchema;
@@ -397,6 +561,17 @@ exports.VoiceConversationDeniedSchema = VoiceConversationDeniedSchema;
 exports.VoiceConversationGrantedSchema = VoiceConversationGrantedSchema;
 exports.VoiceConversationResponseSchema = VoiceConversationResponseSchema;
 exports.VoiceUsageResponseSchema = VoiceUsageResponseSchema;
+exports.WorkflowActionSchema = WorkflowActionSchema;
+exports.WorkflowAgentSchema = WorkflowAgentSchema;
+exports.WorkflowDecisionSchema = WorkflowDecisionSchema;
+exports.WorkflowDefinitionSchema = WorkflowDefinitionSchema;
+exports.WorkflowLibrarySchema = WorkflowLibrarySchema;
+exports.WorkflowRunSchema = WorkflowRunSchema;
+exports.WorkflowSlotSchema = WorkflowSlotSchema;
+exports.WorkflowStageSchema = WorkflowStageSchema;
+exports.WorkflowStartSchema = WorkflowStartSchema;
+exports.WorkflowStepSchema = WorkflowStepSchema;
+exports.WorkflowTaskSchema = WorkflowTaskSchema;
 exports.authenticationContexts = authenticationContexts;
 exports.createEnvelope = createEnvelope;
 exports.encryptionContexts = encryptionContexts;
@@ -418,3 +593,7 @@ exports.sessionTurnEndEventSchema = sessionTurnEndEventSchema;
 exports.sessionTurnEndStatusSchema = sessionTurnEndStatusSchema;
 exports.sessionTurnStartEventSchema = sessionTurnStartEventSchema;
 exports.toWireMetadata = toWireMetadata;
+exports.workflowEnabled = workflowEnabled;
+exports.workflowProjection = workflowProjection;
+exports.workflowSlots = workflowSlots;
+exports.workflowStageLabel = workflowStageLabel;