@bendyline/gezel 1.0.7 → 1.1.0

package/dist/markdown/index.d.ts

@@ -1,4 +1,4 @@
-import { b as CraftbookDocError, c as CraftbookDoc, U as ParsedGezel, W as ParsedReportAction, a3 as ReportActionParseIssue } from '../report-action-Kt6W23xy.js';
+import { b as CraftbookDocError, c as CraftbookDoc, W as ParsedGezel, Y as ParsedReportAction, a5 as ReportActionParseIssue } from '../report-action-Dn_QrwwK.js';
 import 'zod';
 
 interface CraftbookMarkdownParse {

package/dist/markdown/index.js

@@ -1061,6 +1061,65 @@ var CraftbookStepInputSchema = z6.object({
   /** Read from the artifacts drawer instead of the project workspace. */
   artifact: z6.boolean().optional().describe("True for the artifacts drawer; false/omitted for the project workspace.")
 });
+var CraftbookStepWritableOutputMediumSchema = z6.enum([
+  "workspace",
+  "artifact",
+  "task-note"
+]);
+var CraftbookStepOutputMediumSchema = z6.enum([
+  ...CraftbookStepWritableOutputMediumSchema.options,
+  "none"
+]);
+var CraftbookStepToolPolicySchema = z6.object({
+  disallowToolsets: z6.array(z6.string().trim().min(1)).min(1).optional(),
+  disallowBuiltinToolsets: z6.array(z6.string().trim().min(1)).min(1).optional(),
+  outputMedium: CraftbookStepOutputMediumSchema.optional(),
+  /**
+   * Other intentional write surfaces used while producing the primary
+   * result (for example edit workspace source + emit an artifact report).
+   * `none` is never a secondary medium.
+   */
+  additionalOutputMedia: z6.array(CraftbookStepWritableOutputMediumSchema).min(1).optional()
+}).strict().superRefine((policy, ctx) => {
+  const additional = new Set(policy.additionalOutputMedia ?? []);
+  if (policy.outputMedium === "none" && additional.size > 0) {
+    ctx.addIssue({
+      code: z6.ZodIssueCode.custom,
+      path: ["additionalOutputMedia"],
+      message: "`none` cannot have secondary output media"
+    });
+  }
+  if (policy.outputMedium && policy.outputMedium !== "none" && additional.has(policy.outputMedium)) {
+    ctx.addIssue({
+      code: z6.ZodIssueCode.custom,
+      path: ["additionalOutputMedia"],
+      message: "the primary output medium must not be repeated as a secondary medium"
+    });
+  }
+  const media = /* @__PURE__ */ new Set([policy.outputMedium, ...additional]);
+  const denied = new Set(policy.disallowBuiltinToolsets ?? []);
+  if (media.has("workspace") && denied.has("workspace-fs-write")) {
+    ctx.addIssue({
+      code: z6.ZodIssueCode.custom,
+      path: ["disallowBuiltinToolsets"],
+      message: "workspace output conflicts with disallowing `workspace-fs-write`"
+    });
+  }
+  if (media.has("artifact") && denied.has("artifacts")) {
+    ctx.addIssue({
+      code: z6.ZodIssueCode.custom,
+      path: ["disallowBuiltinToolsets"],
+      message: "artifact output conflicts with disallowing `artifacts`"
+    });
+  }
+  if (media.has("task-note") && denied.has("tasks")) {
+    ctx.addIssue({
+      code: z6.ZodIssueCode.custom,
+      path: ["disallowBuiltinToolsets"],
+      message: "task-note output conflicts with disallowing `tasks`"
+    });
+  }
+});
 var ModelTierSchema = z6.enum(MODEL_TIER_ORDER);
 var CraftbookStepSchema = z6.object({
   id: z6.string().min(1),
@@ -1094,13 +1153,17 @@ var CraftbookStepSchema = z6.object({
   capabilityFloor: ModelTierSchema.optional(),
   /** Per-phase indexed-context policy; overrides gezel and install defaults. */
   retrieval: RetrievalPolicySchema.optional(),
+  /** Per-step subtractive tool and output-surface policy. */
+  toolPolicy: CraftbookStepToolPolicySchema.optional(),
   assignee: TaskAssigneeSchema.optional(),
   /** Setup scripts, run in order when the step activates. Single ref = legacy shape. */
   onEnter: ScriptRefListSchema.optional(),
   /**
    * Cleanup scripts — the `finally` of the step. Run in order AFTER the
-   * gate (if any) approves; never on a gate reject. Branch predicates
-   * read the LAST ref's output (legacy routing; prefer gate routing).
+   * gate (if any) approves; never on a gate reject. Every script must
+   * succeed or the step remains incomplete and the task pauses. Branch
+   * predicates read the LAST ref's output (legacy routing; prefer gate
+   * routing).
    */
   onExit: ScriptRefListSchema.optional(),
   /** Required file inputs for this step, in the order they should be opened. */
@@ -1485,6 +1548,8 @@ var NewCraftbookStepSchema = z6.object({
   capabilityFloor: ModelTierSchema.optional(),
   /** See {@link CraftbookStepSchema.shape.retrieval}. */
   retrieval: RetrievalPolicySchema.optional(),
+  /** See {@link CraftbookStepSchema.shape.toolPolicy}. */
+  toolPolicy: CraftbookStepToolPolicySchema.optional(),
   assignee: TaskAssigneeSchema.optional(),
   onEnter: ScriptRefListSchema.optional(),
   onExit: ScriptRefListSchema.optional(),
@@ -1792,6 +1857,8 @@ var STEP_FENCE_KEYS = [
   "suggestedGezelId",
   "suggestedRole",
   "capabilityFloor",
+  "retrieval",
+  "toolPolicy",
   "assignee",
   "deliverable",
   "onEnter",
@@ -2629,6 +2696,7 @@ var TaskPausedReasonSchema = z15.enum([
   "gate_plateau",
   "gate_unsatisfiable",
   "gate_infrastructure",
+  "step_exit_infrastructure",
   "step_stalled",
   "budget_exhausted"
 ]);
@@ -3261,6 +3329,14 @@ var ToolCallCardSchema = z19.discriminatedUnion("kind", [
 ]);
 var ChatMessageToolCallSchema = z19.object({
   name: z19.string(),
+  /**
+   * ISO timestamp of the call's START. Optional: absent on every message
+   * persisted before this field existed, so readers must not assume it.
+   * End time derives as `at + durationMs`. This is what gives replay
+   * (run recordings, the eval movie pipeline) intra-turn ordering with
+   * absolute time — array order alone cannot place calls on a timeline.
+   */
+  at: z19.string().optional(),
   durationMs: z19.number(),
   success: z19.boolean(),
   errorMessage: z19.string().optional(),
@@ -3344,13 +3420,31 @@ var ReferencedFileSchema = z19.object({
   kind: ReferencedFileKindSchema,
   path: z19.string()
 });
+var ContextCompactionSchema = z19.object({
+  removedCount: z19.number().int().nonnegative(),
+  contextWindow: z19.number().int().positive(),
+  estimatedTokensBefore: z19.number().int().nonnegative(),
+  compactionCount: z19.number().int().positive(),
+  autoCompactRatio: z19.number().positive().max(1)
+});
 var ChatMessageSchema = z19.object({
   role: z19.enum(["user", "assistant"]),
   content: z19.string(),
   at: z19.string(),
   from: z19.object({
     gezelId: z19.string(),
-    gezelName: z19.string()
+    gezelName: z19.string(),
+    /**
+     * The SENDER's session id — the durable per-edge record of which
+     * thread this message came from. `session.parentSession` only says
+     * which session first opened the thread (stable containment);
+     * this field is the ground truth for every individual delegation
+     * edge, including later senders into an existing session. Optional:
+     * absent on messages persisted before the field existed.
+     */
+    sessionId: z19.string().optional(),
+    /** How the sender reached this session; mirrors SessionParent.kind. */
+    kind: z19.enum(["delegation", "consultation", "task-entry", "task-handoff"]).optional()
   }).optional(),
   /**
    * Real files the assistant reply named in its body text — artifacts
@@ -3465,6 +3559,13 @@ var ChatMessageSchema = z19.object({
     "growth-announcement",
     "keurmeester-notice"
   ]).optional(),
+  /**
+   * Present on a synthetic `compaction-summary` message. The UI renders this
+   * as an explicit context-maintenance marker (including the effective token
+   * window and number of messages summarized) rather than pretending it was
+   * an ordinary assistant reply.
+   */
+  contextCompaction: ContextCompactionSchema.optional(),
   /**
    * Display flag: the model sees this message as normal history, but the
    * chat transcript UI never renders a bubble for it. Set on
@@ -3485,6 +3586,13 @@ var ChatMessageSchema = z19.object({
    * renders a small "nudged" chip on the bubble.
    */
   nudge: z19.boolean().optional(),
+  /**
+   * The prompt draft (`artifacts/prompts/<draftId>/`) this user message was
+   * sent from. Display-only: the model never sees it, and the draft may since
+   * have been swept, so the UI must treat a dangling id as "no prompt to
+   * open" rather than an error.
+   */
+  draftId: z19.string().optional(),
   /**
    * The machinery — not the human — authored this `role: 'user'` message.
    * Task dispatch seeds, step handoffs, and project-page reaction seeds
@@ -3620,6 +3728,8 @@ var ChatEventSchema = z19.discriminatedUnion("type", [
   z19.object({
     type: z19.literal("tool"),
     name: z19.string(),
+    /** ISO start-of-call timestamp; see ChatMessageToolCallSchema.at. */
+    at: z19.string().optional(),
     durationMs: z19.number(),
     success: z19.boolean(),
     errorMessage: z19.string().optional(),
@@ -3795,16 +3905,33 @@ var ChatEventSchema = z19.discriminatedUnion("type", [
     reason: z19.enum(["started", "canceled", "rejected"])
   }),
   /**
-   * Local-provider context policy: emitted when accumulated conversation
-   * exceeds a safety fraction of the session's effective model context.
-   * The UI may suggest starting fresh because this event is never emitted
-   * for a first-turn standing system/tool prefix.
+   * Effective context policy for a local or remote-local session. Emitted on
+   * each turn so the live UI can show the model's token window immediately;
+   * the same values are persisted on the session for reloads.
+   */
+  z19.object({
+    type: z19.literal("context_window"),
+    numCtx: z19.number().int().positive(),
+    model: z19.string(),
+    autoCompactRatio: z19.number().positive().max(1),
+    /**
+     * Estimated prompt size for the turn about to run, in the same
+     * chars/4 units the compaction check itself uses. Absent on older
+     * daemons, which published the window without the fill.
+     */
+    estimatedTokens: z19.number().int().nonnegative().optional()
+  }),
+  /**
+   * Local-provider context policy: emitted only when accumulated conversation
+   * could not be compacted automatically. Normal pressure is handled without
+   * a warning; this is the exceptional maintenance-failure path.
    */
   z19.object({
     type: z19.literal("context_warning"),
     estimatedTokens: z19.number(),
     numCtx: z19.number(),
-    model: z19.string()
+    model: z19.string(),
+    reason: z19.literal("compaction_failed").optional()
   }),
   /**
    * Local-provider context policy: emitted right after in-flight compaction collapses
@@ -3816,7 +3943,13 @@ var ChatEventSchema = z19.discriminatedUnion("type", [
   z19.object({
     type: z19.literal("context_compacted"),
     removedCount: z19.number().int().nonnegative(),
-    model: z19.string()
+    model: z19.string(),
+    /** Optional for wire compatibility with pre-context-visibility daemons. */
+    numCtx: z19.number().int().positive().optional(),
+    estimatedTokensBefore: z19.number().int().nonnegative().optional(),
+    autoCompactRatio: z19.number().positive().max(1).optional(),
+    compactionCount: z19.number().int().positive().optional(),
+    mode: z19.enum(["between-turn", "mid-turn"]).optional()
   }),
   /**
    * Emitted when the chat manager detects a self-chat / compaction loop —
@@ -4113,6 +4246,26 @@ var ChatEventSchema = z19.discriminatedUnion("type", [
     gezelId: z19.string(),
     name: z19.string()
   }),
+  /**
+   * A prompt draft was created, edited, re-filed, sent, or removed. Emitted
+   * on the project stream so a thread picker open in another window folds the
+   * change in. Content-only churn rides this event too (autosave fires it
+   * about once a second per typing user), so consumers must debounce and
+   * should ignore an event for the draft they are themselves editing.
+   *
+   * `gezelId` is the draft's, not the envelope's: a draft that will start a
+   * new thread has no session for the envelope to be scoped by.
+   */
+  z19.object({
+    type: z19.literal("prompt_draft_changed"),
+    projectId: z19.string(),
+    gezelId: z19.string(),
+    draftId: z19.string(),
+    sessionId: z19.string().nullable(),
+    status: z19.enum(["draft", "sent"]),
+    deleted: z19.boolean().optional(),
+    updatedAt: z19.string()
+  }),
   /**
    * Global (project-less) signal that Night Shift mode flipped ON/OFF.
    * Emitted by `NightShiftManager` on every state transition so the UI

package/dist/paths.d.ts

@@ -290,6 +290,18 @@ declare const PROJECT_DIFFPACKS_DIR_NAME = "diffpacks";
 declare function projectDiffpacksDir(root: string, projectId: string, external?: ExternalFolders): string;
 /** One pack's folder: `artifacts/diffpacks/<packId>/`. */
 declare function projectDiffpackDir(root: string, projectId: string, packId: string, external?: ExternalFolders): string;
+/**
+ * Reserved artifacts subtree holding the user's chat prompt drafts. Each draft
+ * owns `message.md` (the prompt markdown), `message_files/` (its uploads,
+ * referenced document-relatively while editing) and `draft.json` (thread
+ * association, status, sent stamps). Lives under artifacts so a draft is an
+ * ordinary inspectable file the user can open, back up, and grep.
+ */
+declare const PROJECT_PROMPTS_DIR_NAME = "prompts";
+/** Per-project `artifacts/prompts/` root. */
+declare function projectPromptsDir(root: string, projectId: string, external?: ExternalFolders): string;
+/** One draft's folder: `artifacts/prompts/<draftId>/`. */
+declare function projectPromptDraftDir(root: string, projectId: string, draftId: string, external?: ExternalFolders): string;
 /** Per-project memories folder (daily markdown + summary + vectra index). */
 declare function projectMemoriesDir(root: string, projectId: string, external?: ExternalFolders): string;
 /**
@@ -726,4 +738,4 @@ declare function binRuntimeRoot(root: string): string;
  */
 declare function readConfigRaw(root: string): Promise<Record<string, unknown>>;
 
-export { CONNECTOR_ROLLUPS_DIR_NAME, CONNECTOR_TABLES_DIR_NAME, type ExternalFolders, type GezelPaths, MACHINE_SHARED_MARKER, type MachineStorageScope, OBSERVATION_TABLE_MANIFEST_FILE, OBSERVATION_TABLE_STATE_FILE, PROJECT_DIFFPACKS_DIR_NAME, PROJECT_SHADOW_DIR_NAME, PROJECT_TABULAR_DIR_NAME, TABULAR_COMPANION_SUFFIX, activeMachineSharedHome, aiAppItemsDir, aiAppReceiptFile, aiAppVersionDir, aiAppsRegistryFile, aiAppsRoot, ambientDashboardLatestFile, ambientDashboardStateFile, ambientDir, ambientDisplayStateFile, backupsDir, binRuntimeRoot, channelsDir, craftbookShardPrefix, craftbookTemplateDir, craftbookTemplateManifestFile, craftbookTemplateScriptFile, craftbookTemplateScriptsDir, craftbookTemplateVersionDir, craftbookTemplateVersionManifestFile, craftbookTemplatesRoot, daemonTransactionsRoot, deviceIdentityFile, enginesRoot, fallbackProjectIndexDir, fallbackProjectVillageFile, foldersStateDir, gezelDir, gezelGrowthPath, gezelHome, gezelLocalDir, gezelMemoriesDir, gezelPaths, gezelPoppetjePath, gezelSessionFile, gezelSessionsDir, gezelStorageScope, gezelToolsPath, gezelToolsetsFile, gezelToolsetsInstallDir, gildeLiveRoot, gildeLiveStateFile, gildeLiveVersionDir, gildeLiveVersionsDir, globalHistoryFile, globalIndexDbFile, globalIndexDir, keurmeesterCasesDir, keurmeesterDigestStatePath, keurmeesterDigestsDir, keurmeesterDir, knowledgeCatalogVersionDir, knowledgeCatalogsDir, knowledgeDir, knowledgeDownloadsDir, knowledgeRegistryFile, machineSharedGezelDir, machineSharedHome, machineSharedMarkerFile, machineSharedProjectDir, meesterStatusDir, meesterStatusFile, meesterStatusStateFile, pendingGrantsFile, pendingHandoffsFile, playwrightBrowsersDir, projectActivityFile, projectArtifactsDir, projectArtifactsIndexDbFile, projectBoekwachterIssuesFile, projectCodeReviewsFile, projectContentIndexDbFile, projectCreateTransactionsRoot, projectDiffpackDir, projectDiffpacksDir, projectDiffpacksFile, projectDir, projectDocsDir, projectFindingLifecycleFile, projectHistoryFile, projectIndexDir, projectInternalGithubDir, projectLocalConfigFile, projectLocalCraftbookDir, projectLocalCraftbooksRoot, projectLocalDir, projectLocalFilesDir, projectLocalGezelDir, projectLocalGezelsRoot, projectLocalImportsFile, projectLocalIndexDbFile, projectLocalIndexDir, projectLocalPendingImportsFile, projectLocalQuarantineDir, projectLocalRoot, projectLocalVillageFile, projectMemoriesDir, projectMemoryIndexDir, projectMetaFile, projectPrivateDir, projectQuestionsFile, projectReportActionsFile, projectScriptFile, projectScriptRunFile, projectScriptRunsDir, projectScriptsDir, projectShadowDir, projectStorageDir, projectStorageScope, projectTabularDir, projectTaskAboutFile, projectTaskDir, projectTaskFile, projectTaskNextIdFile, projectTaskNotesFile, projectTasksDir, projectTerminalFile, projectTerminalsDir, projectToolsetsFile, projectToolsetsInstallDir, projectTypeDir, projectTypeManifestFile, projectTypeOverlayFile, projectTypeShardPrefix, projectTypeVersionDir, projectTypeVersionManifestFile, projectTypesRoot, readConfigRaw, remotesFile, secretsFile, secretsKeyFile, sharedCloneDir, sharedClonesRoot, sharedToolsetsFile, sharedToolsetsInstallDir, systemInstalledToolsetsFile, systemToolsetsFile, systemToolsetsInstallDir, tokensFile, toolsetConfigFile, toolsetConfigsDir, userGezelDir, userProjectDir, userScriptFile, userScriptsDir };
+export { CONNECTOR_ROLLUPS_DIR_NAME, CONNECTOR_TABLES_DIR_NAME, type ExternalFolders, type GezelPaths, MACHINE_SHARED_MARKER, type MachineStorageScope, OBSERVATION_TABLE_MANIFEST_FILE, OBSERVATION_TABLE_STATE_FILE, PROJECT_DIFFPACKS_DIR_NAME, PROJECT_PROMPTS_DIR_NAME, PROJECT_SHADOW_DIR_NAME, PROJECT_TABULAR_DIR_NAME, TABULAR_COMPANION_SUFFIX, activeMachineSharedHome, aiAppItemsDir, aiAppReceiptFile, aiAppVersionDir, aiAppsRegistryFile, aiAppsRoot, ambientDashboardLatestFile, ambientDashboardStateFile, ambientDir, ambientDisplayStateFile, backupsDir, binRuntimeRoot, channelsDir, craftbookShardPrefix, craftbookTemplateDir, craftbookTemplateManifestFile, craftbookTemplateScriptFile, craftbookTemplateScriptsDir, craftbookTemplateVersionDir, craftbookTemplateVersionManifestFile, craftbookTemplatesRoot, daemonTransactionsRoot, deviceIdentityFile, enginesRoot, fallbackProjectIndexDir, fallbackProjectVillageFile, foldersStateDir, gezelDir, gezelGrowthPath, gezelHome, gezelLocalDir, gezelMemoriesDir, gezelPaths, gezelPoppetjePath, gezelSessionFile, gezelSessionsDir, gezelStorageScope, gezelToolsPath, gezelToolsetsFile, gezelToolsetsInstallDir, gildeLiveRoot, gildeLiveStateFile, gildeLiveVersionDir, gildeLiveVersionsDir, globalHistoryFile, globalIndexDbFile, globalIndexDir, keurmeesterCasesDir, keurmeesterDigestStatePath, keurmeesterDigestsDir, keurmeesterDir, knowledgeCatalogVersionDir, knowledgeCatalogsDir, knowledgeDir, knowledgeDownloadsDir, knowledgeRegistryFile, machineSharedGezelDir, machineSharedHome, machineSharedMarkerFile, machineSharedProjectDir, meesterStatusDir, meesterStatusFile, meesterStatusStateFile, pendingGrantsFile, pendingHandoffsFile, playwrightBrowsersDir, projectActivityFile, projectArtifactsDir, projectArtifactsIndexDbFile, projectBoekwachterIssuesFile, projectCodeReviewsFile, projectContentIndexDbFile, projectCreateTransactionsRoot, projectDiffpackDir, projectDiffpacksDir, projectDiffpacksFile, projectDir, projectDocsDir, projectFindingLifecycleFile, projectHistoryFile, projectIndexDir, projectInternalGithubDir, projectLocalConfigFile, projectLocalCraftbookDir, projectLocalCraftbooksRoot, projectLocalDir, projectLocalFilesDir, projectLocalGezelDir, projectLocalGezelsRoot, projectLocalImportsFile, projectLocalIndexDbFile, projectLocalIndexDir, projectLocalPendingImportsFile, projectLocalQuarantineDir, projectLocalRoot, projectLocalVillageFile, projectMemoriesDir, projectMemoryIndexDir, projectMetaFile, projectPrivateDir, projectPromptDraftDir, projectPromptsDir, projectQuestionsFile, projectReportActionsFile, projectScriptFile, projectScriptRunFile, projectScriptRunsDir, projectScriptsDir, projectShadowDir, projectStorageDir, projectStorageScope, projectTabularDir, projectTaskAboutFile, projectTaskDir, projectTaskFile, projectTaskNextIdFile, projectTaskNotesFile, projectTasksDir, projectTerminalFile, projectTerminalsDir, projectToolsetsFile, projectToolsetsInstallDir, projectTypeDir, projectTypeManifestFile, projectTypeOverlayFile, projectTypeShardPrefix, projectTypeVersionDir, projectTypeVersionManifestFile, projectTypesRoot, readConfigRaw, remotesFile, secretsFile, secretsKeyFile, sharedCloneDir, sharedClonesRoot, sharedToolsetsFile, sharedToolsetsInstallDir, systemInstalledToolsetsFile, systemToolsetsFile, systemToolsetsInstallDir, tokensFile, toolsetConfigFile, toolsetConfigsDir, userGezelDir, userProjectDir, userScriptFile, userScriptsDir };