@openspecui/core 3.2.3 → 3.3.0

package/dist/index.d.mts

@@ -20,13 +20,13 @@ declare const ChangeFileSchema: z.ZodObject<{
   /** Optional byte size for files */
   size: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   type: "file" | "directory";
+  path: string;
   content?: string | undefined;
   size?: number | undefined;
 }, {
-  path: string;
   type: "file" | "directory";
+  path: string;
   content?: string | undefined;
   size?: number | undefined;
 }>;
@@ -307,11 +307,11 @@ declare const DeltaSpecSchema: z.ZodObject<{
   /** Raw markdown content of the delta spec */
   content: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-  content: string;
   specId: string;
-}, {
   content: string;
+}, {
   specId: string;
+  content: string;
 }>;
 type DeltaSpec = z.infer<typeof DeltaSpecSchema>;
 /**
@@ -489,11 +489,11 @@ declare const ChangeSchema: z.ZodObject<{
     /** Raw markdown content of the delta spec */
     content: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    content: string;
     specId: string;
-  }, {
     content: string;
+  }, {
     specId: string;
+    content: string;
   }>, "many">>;
   /** Optional metadata */
   metadata: z.ZodOptional<z.ZodObject<{
@@ -550,8 +550,8 @@ declare const ChangeSchema: z.ZodObject<{
   } | undefined;
   design?: string | undefined;
   deltaSpecs?: {
-    content: string;
     specId: string;
+    content: string;
   }[] | undefined;
 }, {
   id: string;
@@ -597,8 +597,8 @@ declare const ChangeSchema: z.ZodObject<{
   } | undefined;
   design?: string | undefined;
   deltaSpecs?: {
-    content: string;
     specId: string;
+    content: string;
   }[] | undefined;
 }>;
 type Change = z.infer<typeof ChangeSchema>;
@@ -804,8 +804,8 @@ declare class OpenSpecAdapter {
       } | undefined;
       design?: string | undefined;
       deltaSpecs?: {
-        content: string;
         specId: string;
+        content: string;
       }[] | undefined;
     }[];
     archivedCount: number;
@@ -1456,9 +1456,9 @@ type GitConfig = z.infer<typeof GitConfigSchema>;
 declare const OpsxConfigSchema: z.ZodObject<{
   agentInvocationMode: z.ZodDefault<z.ZodEnum<["compose", "command"]>>;
 }, "strip", z.ZodTypeAny, {
-  agentInvocationMode: "compose" | "command";
+  agentInvocationMode: "command" | "compose";
 }, {
-  agentInvocationMode?: "compose" | "command" | undefined;
+  agentInvocationMode?: "command" | "compose" | undefined;
 }>;
 type OpsxConfig = z.infer<typeof OpsxConfigSchema>;
 /**
@@ -1496,9 +1496,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   opsx: z.ZodDefault<z.ZodObject<{
     agentInvocationMode: z.ZodDefault<z.ZodEnum<["compose", "command"]>>;
   }, "strip", z.ZodTypeAny, {
-    agentInvocationMode: "compose" | "command";
+    agentInvocationMode: "command" | "compose";
   }, {
-    agentInvocationMode?: "compose" | "command" | undefined;
+    agentInvocationMode?: "command" | "compose" | undefined;
   }>>;
   /** 终端配置 */
   terminal: z.ZodDefault<z.ZodObject<{
@@ -1559,7 +1559,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   };
   appBaseUrl: string;
   opsx: {
-    agentInvocationMode: "compose" | "command";
+    agentInvocationMode: "command" | "compose";
   };
   terminal: {
     fontSize: number;
@@ -1589,7 +1589,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   } | undefined;
   appBaseUrl?: string | undefined;
   opsx?: {
-    agentInvocationMode?: "compose" | "command" | undefined;
+    agentInvocationMode?: "command" | "compose" | undefined;
   } | undefined;
   terminal?: {
     fontSize?: number | undefined;
@@ -2441,7 +2441,10 @@ interface ExportSnapshot {
   specs: Array<{
     id: string;
     name: string;
+    /** Processed markdown shown by default in static OpenSpecUI. */
     content: string;
+    /** Original source markdown, preserved for raw/source views. */
+    sourceContent?: string;
     overview: string;
     requirements: Array<{
       id: string;
@@ -2457,9 +2460,14 @@ interface ExportSnapshot {
   changes: Array<{
     id: string;
     name: string;
+    /** Processed proposal markdown shown by default in static OpenSpecUI. */
     proposal: string;
+    /** Original source proposal markdown. */
+    sourceProposal?: string;
     tasks?: string;
+    sourceTasks?: string;
     design?: string;
+    sourceDesign?: string;
     why: string;
     whatChanges: string;
     parsedTasks: Array<{
@@ -2470,7 +2478,10 @@ interface ExportSnapshot {
     }>;
     deltas: Array<{
       capability: string;
+      /** Processed delta spec markdown. */
       content: string;
+      /** Original source delta spec markdown. */
+      sourceContent?: string;
     }>;
     progress: {
       total: number;
@@ -2483,9 +2494,14 @@ interface ExportSnapshot {
   archives: Array<{
     id: string;
     name: string;
+    /** Processed proposal markdown shown by default in static OpenSpecUI. */
     proposal: string;
+    /** Original source proposal markdown. */
+    sourceProposal?: string;
     tasks?: string;
+    sourceTasks?: string;
     design?: string;
+    sourceDesign?: string;
     why: string;
     whatChanges: string;
     parsedTasks: Array<{
@@ -2580,6 +2596,131 @@ interface GitWorktreeHandoff {
   serverUrl: string;
 }
 //#endregion
+//#region src/hooks.d.ts
+declare const OPENSPECUI_HOOKS_VERSION = 1;
+/** Severity level for diagnostics returned by project hooks. */
+type HookDiagnosticLevel = 'info' | 'warning' | 'error';
+/** Non-fatal hook diagnostic surfaced with the processed result. */
+interface HookDiagnosticV1 {
+  level: HookDiagnosticLevel;
+  message: string;
+}
+/** Project-scoped lifecycle helpers available to hooks. */
+interface HookLifecycleV1 {
+  /**
+   * Register cleanup work for the project hook runtime.
+   *
+   * This lifecycle is project-scoped, not call-scoped, so daemon-style hooks can
+   * keep one process alive for the OpenSpecUI session.
+   */
+  onDispose(cleanup: () => void | Promise<void>): void;
+}
+/** OpenSpecUI consumer requesting a processed document projection. */
+type DocumentConsumerV1 = 'view' | 'search' | 'export';
+/** Document read mode; source reads bypass hooks and stay audit-safe. */
+type DocumentReadModeV1 = 'source' | 'processed';
+/** Stable identity for the OpenSpec document currently being read. */
+interface DocumentRefV1 {
+  stage: 'project' | 'main' | 'change' | 'archive';
+  kind: 'project' | 'spec' | 'proposal' | 'design' | 'tasks' | 'delta-spec';
+  relativePath: string;
+  absolutePath: string;
+  specId?: string;
+  changeId?: string;
+}
+/** Context passed to `onReadDocument`. */
+interface ReadDocumentContextV1 {
+  version: typeof OPENSPECUI_HOOKS_VERSION;
+  projectDir: string;
+  consumer: DocumentConsumerV1;
+  document: DocumentRefV1;
+  signal: AbortSignal;
+  lifecycle: HookLifecycleV1;
+}
+/** Markdown projection returned by document reads and `onReadDocument`. */
+interface ReadDocumentResultV1 {
+  markdown: string;
+  sourceLabel?: string;
+  title?: string;
+  diagnostics?: HookDiagnosticV1[];
+  watchFiles?: string[];
+}
+/** Intercepts processed OpenSpec markdown reads for view, search, and export. */
+type OnReadDocumentHookV1 = (ctx: ReadDocumentContextV1, read: () => Promise<ReadDocumentResultV1>) => Promise<ReadDocumentResultV1>;
+/** OPSX workflow action names that can be customized by `onRunWorkflow`. */
+type WorkflowActionV1 = 'explore' | 'propose' | 'new' | 'continue' | 'ff' | 'apply' | 'verify' | 'sync' | 'archive' | 'bulk-archive' | 'onboard';
+/** Invocation mode requested by the UI before action-specific fallback resolution. */
+type WorkflowRequestedModeV1 = 'compose' | 'command' | 'direct';
+/** Normalized OPSX workflow input passed to `onRunWorkflow`. */
+type RunWorkflowInputV1 = {
+  action: 'explore' | 'propose';
+  text: string;
+} | {
+  action: 'new';
+  changeId: string;
+  schema?: string;
+  description?: string;
+  extraArgs: string[];
+} | {
+  action: 'continue' | 'ff';
+  changeId: string;
+  artifactId: string;
+  schema?: string;
+} | {
+  action: 'apply' | 'archive' | 'verify' | 'sync';
+  changeId: string;
+  schema?: string;
+  strict?: boolean;
+} | {
+  action: 'bulk-archive';
+  changeIds?: string[];
+  schema?: string;
+} | {
+  action: 'onboard';
+};
+/** Actual invocation mode after OpenSpecUI applies action capability rules. */
+interface WorkflowInvocationModeResolutionV1 {
+  requestedMode: WorkflowRequestedModeV1;
+  actualMode: WorkflowRequestedModeV1;
+  fallbackReason: string | null;
+}
+/** Context passed to `onRunWorkflow`. */
+interface RunWorkflowContextV1 {
+  version: typeof OPENSPECUI_HOOKS_VERSION;
+  projectDir: string;
+  action: WorkflowActionV1;
+  requestedMode: WorkflowRequestedModeV1;
+  input: RunWorkflowInputV1;
+  signal: AbortSignal;
+  lifecycle: HookLifecycleV1;
+}
+/** Final OPSX invocation payload produced by OpenSpecUI or `onRunWorkflow`. */
+type RunWorkflowResultV1 = {
+  kind: 'agent-prompt';
+  text: string;
+  format: 'markdown';
+  mode?: WorkflowInvocationModeResolutionV1;
+  diagnostics?: HookDiagnosticV1[];
+} | {
+  kind: 'agent-command';
+  text: string;
+  mode?: WorkflowInvocationModeResolutionV1;
+  diagnostics?: HookDiagnosticV1[];
+} | {
+  kind: 'cli-command';
+  command: string;
+  args: string[];
+  mode?: WorkflowInvocationModeResolutionV1;
+  diagnostics?: HookDiagnosticV1[];
+};
+/** Intercepts the final OPSX invocation payload before the UI runs it. */
+type OnRunWorkflowHookV1 = (ctx: RunWorkflowContextV1, run: () => Promise<RunWorkflowResultV1>) => Promise<RunWorkflowResultV1>;
+/** Project hook module shape exported from `openspec/openspecui.hooks.ts`. */
+interface OpenSpecUIHooksV1 {
+  onReadDocument?: OnReadDocumentHookV1;
+  onRunWorkflow?: OnRunWorkflowHookV1;
+}
+//#endregion
 //#region src/runtime-types.d.ts
 type ProjectRecoveryStatus = {
   state: 'idle';
@@ -2721,22 +2862,22 @@ declare const PtySessionInfoSchema: z.ZodObject<{
   closeTip: z.ZodOptional<z.ZodString>;
   closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
 }, "strip", z.ZodTypeAny, {
-  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
+  id: string;
   isExited: boolean;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
-  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
+  id: string;
   isExited: boolean;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2753,19 +2894,19 @@ declare const PtyCreateMessageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>;
@@ -2843,19 +2984,19 @@ declare const PtyClientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>, z.ZodObject<{
@@ -2997,22 +3138,22 @@ declare const PtyListResponseSchema: z.ZodObject<{
     closeTip: z.ZodOptional<z.ZodString>;
     closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
   }, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3020,12 +3161,12 @@ declare const PtyListResponseSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
   type: "list";
   sessions: {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3033,12 +3174,12 @@ declare const PtyListResponseSchema: z.ZodObject<{
 }, {
   type: "list";
   sessions: {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3137,22 +3278,22 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     closeTip: z.ZodOptional<z.ZodString>;
     closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
   }, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3160,12 +3301,12 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "strip", z.ZodTypeAny, {
   type: "list";
   sessions: {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3173,12 +3314,12 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, {
   type: "list";
   sessions: {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3204,4 +3345,4 @@ type PtyServerMessage = z.infer<typeof PtyServerMessageSchema>;
 type PtySessionInfo = z.infer<typeof PtySessionInfoSchema>;
 type PtyPlatform = z.infer<typeof PtyPlatformSchema>;
 //#endregion
-export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, type CodeEditorTheme, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, type DashboardCardAvailability, type DashboardConfig, DashboardConfigSchema, type DashboardGitCommitEntry, type DashboardGitDiffStats, type DashboardGitEntry, type DashboardGitSnapshot, type DashboardGitUncommittedEntry, type DashboardGitWorktree, type DashboardMetricKey, type DashboardOverview, type DashboardSummary, type DashboardTrendKind, type DashboardTrendMeta, type DashboardTrendPoint, type DashboardTriColorTrendPoint, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type ExportSnapshot, type FileChangeEvent, type FileChangeType, type GitConfig, GitConfigSchema, type GitEntriesPage, type GitEntryCursor, type GitEntryDetail, type GitEntryFileDiff, type GitEntryFilePatch, type GitEntryFileSource, type GitEntryFileSummary, type GitEntryFiles, type GitEntryPatch, type GitEntrySelector, type GitEntryShell, type GitFileChangeType, type GitPatchFile, type GitPatchState, type GitWorktreeHandoff, type GitWorktreeOverview, type GitWorktreeSummary, HOSTED_SHELL_PROTOCOL_VERSION, type HostedBackendHealthResponse, MarkdownParser, OFFICIAL_APP_BASE_URL, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, type OpsxAgentInvocationMode, OpsxAgentInvocationModeSchema, type OpsxConfig, OpsxConfigSchema, OpsxKernel, type PathCallback, type ProjectRecoveryStatus, type ProjectResidencyEvictionReason, type ProjectResidencyStatus, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, type ProjectWatcherRuntimeStatusListener, PtyAttachMessageSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type Requirement, RequirementSchema, type ResolvedCliRunner, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, type Spec, type SpecMeta, SpecSchema, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TOOL_WORKFLOW_TO_SKILL_DIR, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type TerminalThemeId, type TerminalThemeMode, TerminalThemeModeSchema, TerminalThemeSchema, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };
+export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, type CodeEditorTheme, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, type DashboardCardAvailability, type DashboardConfig, DashboardConfigSchema, type DashboardGitCommitEntry, type DashboardGitDiffStats, type DashboardGitEntry, type DashboardGitSnapshot, type DashboardGitUncommittedEntry, type DashboardGitWorktree, type DashboardMetricKey, type DashboardOverview, type DashboardSummary, type DashboardTrendKind, type DashboardTrendMeta, type DashboardTrendPoint, type DashboardTriColorTrendPoint, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type DocumentConsumerV1, type DocumentReadModeV1, type DocumentRefV1, type ExportSnapshot, type FileChangeEvent, type FileChangeType, type GitConfig, GitConfigSchema, type GitEntriesPage, type GitEntryCursor, type GitEntryDetail, type GitEntryFileDiff, type GitEntryFilePatch, type GitEntryFileSource, type GitEntryFileSummary, type GitEntryFiles, type GitEntryPatch, type GitEntrySelector, type GitEntryShell, type GitFileChangeType, type GitPatchFile, type GitPatchState, type GitWorktreeHandoff, type GitWorktreeOverview, type GitWorktreeSummary, HOSTED_SHELL_PROTOCOL_VERSION, type HookDiagnosticLevel, type HookDiagnosticV1, type HookLifecycleV1, type HostedBackendHealthResponse, MarkdownParser, OFFICIAL_APP_BASE_URL, OPENSPECUI_HOOKS_VERSION, OPSX_AGENT_INVOCATION_MODE_VALUES, type OnReadDocumentHookV1, type OnRunWorkflowHookV1, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, type OpenSpecUIHooksV1, OpenSpecWatcher, type OpsxAgentInvocationMode, OpsxAgentInvocationModeSchema, type OpsxConfig, OpsxConfigSchema, OpsxKernel, type PathCallback, type ProjectRecoveryStatus, type ProjectResidencyEvictionReason, type ProjectResidencyStatus, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, type ProjectWatcherRuntimeStatusListener, PtyAttachMessageSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type ReadDocumentContextV1, type ReadDocumentResultV1, type Requirement, RequirementSchema, type ResolvedCliRunner, type RunWorkflowContextV1, type RunWorkflowInputV1, type RunWorkflowResultV1, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, type Spec, type SpecMeta, SpecSchema, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TOOL_WORKFLOW_TO_SKILL_DIR, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type TerminalThemeId, type TerminalThemeMode, TerminalThemeModeSchema, TerminalThemeSchema, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, type WorkflowActionV1, type WorkflowInvocationModeResolutionV1, type WorkflowRequestedModeV1, acquireWatcher, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/dist/index.mjs

@@ -3699,6 +3699,10 @@ const DASHBOARD_METRIC_KEYS = [
 	"taskCompletionPercent"
 ];
 
+//#endregion
+//#region src/hooks.ts
+const OPENSPECUI_HOOKS_VERSION = 1;
+
 //#endregion
 //#region src/opsx-types.ts
 /** Check if an outputPath contains glob pattern characters */
@@ -4638,4 +4642,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, GitConfigSchema, HOSTED_SHELL_PROTOCOL_VERSION, MarkdownParser, OFFICIAL_APP_BASE_URL, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxConfigSchema, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TOOL_WORKFLOW_TO_SKILL_DIR, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, TerminalThemeModeSchema, TerminalThemeSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };
+export { AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, GitConfigSchema, HOSTED_SHELL_PROTOCOL_VERSION, MarkdownParser, OFFICIAL_APP_BASE_URL, OPENSPECUI_HOOKS_VERSION, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxConfigSchema, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TOOL_WORKFLOW_TO_SKILL_DIR, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, TerminalThemeModeSchema, TerminalThemeSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "3.2.3",
+  "version": "3.3.0",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",