@fses/workbench-app 0.2.0 → 0.2.2

package/node_modules/@byteluck/agentic-protocol/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@byteluck/agentic-protocol",
+  "version": "2.2.1",
+  "homepage": "https://github.com/vbenjs/vue-vben-admin",
+  "bugs": "https://github.com/vbenjs/vue-vben-admin/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vbenjs/vue-vben-admin.git",
+    "directory": "packages/agentic-protocol"
+  },
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsdown": "^0.21.8",
+    "typescript": "^6.0.2",
+    "@vben/tsconfig": "5.7.1"
+  },
+  "scripts": {
+    "build": "pnpm exec tsdown",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts"
+  }
+}

package/node_modules/@byteluck/workbench-skill-contracts/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2024-present, Vben
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/@byteluck/workbench-skill-contracts/dist/index.d.ts

@@ -0,0 +1,234 @@
+import { z } from "zod";
+
+//#region src/payloads/common.d.ts
+declare const WORKBENCH_SKILL_PAYLOAD_VERSION = 1;
+type WorkbenchSkillPayloadVersion = typeof WORKBENCH_SKILL_PAYLOAD_VERSION;
+type QueryDomain = 'semantic_sql' | 'runtime_metric' | 'query_result' | 'workbench';
+type QueryExecutionSource = 'metric_execute' | 'model_query' | 'sql_execute';
+type QueryExecutionStatus = 'blocked' | 'failed' | 'running' | 'succeeded';
+interface QueryPayloadIssue {
+  message: string;
+  path: string;
+}
+interface QueryPayloadValidationSuccess<T> {
+  ok: true;
+  value: T;
+}
+interface QueryPayloadValidationFailure {
+  issues: QueryPayloadIssue[];
+  ok: false;
+}
+type QueryPayloadValidationResult<T> = QueryPayloadValidationFailure | QueryPayloadValidationSuccess<T>;
+//#endregion
+//#region src/payloads/chart-candidate.d.ts
+type ChartCandidateType = 'area' | 'bar' | 'line' | 'pie' | 'scatter' | 'table';
+interface ChartCandidateDatasetRefV1 {
+  artifactId?: string;
+  sourcePayloadKind: 'query_result';
+}
+interface ChartCandidatePayloadV1 {
+  chartType: ChartCandidateType;
+  dataset: ChartCandidateDatasetRefV1;
+  dimensions: string[];
+  kind: 'chart_candidate';
+  measures: string[];
+  title: string;
+  version: WorkbenchSkillPayloadVersion;
+}
+//#endregion
+//#region src/payloads/data-action.d.ts
+type DataActionDraftStatusV1 = 'cancelled' | 'collecting_fields' | 'executing' | 'failed' | 'matched' | 'permission_checked' | 'success' | 'waiting_confirmation';
+interface DataActionFieldV1 {
+  code: string;
+  name: string;
+  required?: boolean;
+  type?: string;
+}
+interface DataActionDraftPayloadV1 {
+  actionCode: string;
+  actionName: string;
+  appId: string;
+  confirmationRequired: boolean;
+  draftId: string;
+  missingFields: DataActionFieldV1[];
+  modelCode: string;
+  saveDatas: Record<string, unknown>;
+  sideEffectType: string;
+  status: DataActionDraftStatusV1;
+}
+interface DataActionConfirmationPayloadV1 {
+  draft: DataActionDraftPayloadV1;
+  kind: 'data_action_confirmation';
+  prompt: string;
+  version: WorkbenchSkillPayloadVersion;
+}
+interface DataActionResultPayloadV1 {
+  draft: DataActionDraftPayloadV1;
+  error?: {
+    code?: string;
+    message: string;
+    type?: string;
+  };
+  kind: 'data_action_result';
+  result?: {
+    code?: string;
+    data?: unknown;
+    message?: string;
+    state?: string;
+  };
+  status: 'cancelled' | 'failed' | 'success';
+  version: WorkbenchSkillPayloadVersion;
+}
+//#endregion
+//#region src/payloads/query-clarification.d.ts
+type QueryClarificationAnswerMode = 'natural_language' | 'single_choice' | 'multiple_choice' | 'form';
+type QueryClarificationRequestType = 'application_selection' | 'field_selection' | 'metric_selection' | 'model_selection' | 'parameter_fill' | 'scope_confirmation';
+interface QueryClarificationOptionV1 {
+  description?: string;
+  id: string;
+  label: string;
+}
+interface QueryClarificationPayloadV1 {
+  answerMode: QueryClarificationAnswerMode;
+  domain?: QueryDomain;
+  kind: 'query_clarification';
+  options?: QueryClarificationOptionV1[];
+  question: string;
+  requestType: QueryClarificationRequestType;
+  version: WorkbenchSkillPayloadVersion;
+}
+//#endregion
+//#region src/payloads/query-result.d.ts
+interface QueryResultColumnV1 {
+  key: string;
+  label: string;
+  type?: string;
+}
+interface QueryResultExecutionV1 {
+  elapsedMs?: number;
+  source: QueryExecutionSource;
+  status?: QueryExecutionStatus;
+}
+type QueryResultEvidenceSourceV1 = 'semantic_sql' | 'runtime_metric';
+type QueryResultEvidenceCoverageV1 = 'preview_only' | 'full_result_ref' | 'unavailable';
+type QueryResultEvidenceStalenessV1 = 'fresh' | 'stale' | 'unknown';
+type QueryResultEvidenceExecutionSourceV1 = 'sql_execute' | 'metric_execute';
+type QueryResultEvidenceExecutionStatusV1 = 'success' | 'blocked' | 'failed';
+type QueryResultFailureReasonCodeV1 = 'SEMANTIC_CONTEXT_REQUIRED' | 'SEMANTIC_CONTEXT_UNAVAILABLE' | 'SQL_EXECUTION_FAILED' | 'QUERY_RESULT_UNPARSEABLE' | 'QUERY_RESULT_EMPTY' | 'QUERY_RESULT_STALE' | 'CARD_QUERY_REQUIRED' | 'CARD_BINDING_REFRESH_FAILED' | 'PRIVATE_CONTEXT_UNAVAILABLE';
+interface QueryResultEvidenceSummaryV1 {
+  artifactId?: string;
+  bindingId?: string;
+  coverage: QueryResultEvidenceCoverageV1;
+  evidence: {
+    source: QueryResultEvidenceSourceV1;
+  };
+  execution: {
+    elapsedMs?: number;
+    source: QueryResultEvidenceExecutionSourceV1;
+    status: QueryResultEvidenceExecutionStatusV1;
+  };
+  failureReasonCode?: QueryResultFailureReasonCodeV1;
+  resultId: string;
+  rowCount?: number;
+  sourceTurnId: string;
+  staleness: QueryResultEvidenceStalenessV1;
+}
+interface QueryResultArtifactPayloadV1 {
+  columns: QueryResultColumnV1[];
+  evidence?: QueryResultEvidenceSummaryV1;
+  execution: QueryResultExecutionV1;
+  kind: 'query_result';
+  rowCount?: number;
+  rowsPreview: Array<Record<string, unknown>>;
+  title: string;
+  version: WorkbenchSkillPayloadVersion;
+}
+//#endregion
+//#region src/payloads/query-trace.d.ts
+interface QueryTraceSummaryStepV1 {
+  elapsedMs?: number;
+  id: string;
+  label: string;
+  status: QueryExecutionStatus;
+}
+interface QueryTraceSummaryPayloadV1 {
+  kind: 'query_trace_summary';
+  steps: QueryTraceSummaryStepV1[];
+  version: WorkbenchSkillPayloadVersion;
+}
+//#endregion
+//#region src/payloads/workbench-card.d.ts
+type WorkbenchCardPatchOperationV1 = 'delete_card' | 'patch_common_style' | 'patch_echarts' | 'patch_mixed' | 'patch_style' | 'regenerate_card';
+type WorkbenchCardPatchScopeV1 = 'all' | 'global_common' | 'group' | 'single';
+type WorkbenchCardPatchMergeModeV1 = 'arrayMergeById' | 'arrayMergeByType' | 'deepMerge' | 'replace';
+type WorkbenchCardPatchRiskLevelV1 = 'high' | 'low' | 'medium';
+interface WorkbenchCardPatchItemV1 {
+  blockId?: string;
+  mergeMode: WorkbenchCardPatchMergeModeV1;
+  path: string;
+  reason: string;
+  value?: unknown;
+}
+interface WorkbenchCardPatchPlanPayloadV1 {
+  operation: WorkbenchCardPatchOperationV1;
+  patches: WorkbenchCardPatchItemV1[];
+  requiresConfirmation: boolean;
+  riskLevel: WorkbenchCardPatchRiskLevelV1;
+  scope: WorkbenchCardPatchScopeV1;
+  summary: string;
+  targetBlockIds: string[];
+  targetSummary: string;
+  warnings: string[];
+}
+interface WorkbenchCardPatchPayloadV1 {
+  kind: 'workbench_card_patch';
+  patchPlan: WorkbenchCardPatchPlanPayloadV1;
+  prompt?: string;
+  version: WorkbenchSkillPayloadVersion;
+}
+interface WorkbenchCardLayoutPayloadV1 {
+  h: number;
+  w: number;
+  x: number;
+  y: number;
+}
+interface WorkbenchCardComposeCandidatePayloadV1 {
+  bodyJson: Record<string, unknown>;
+  capabilityId: string;
+  layout: WorkbenchCardLayoutPayloadV1;
+  subtitle?: string;
+  title: string;
+}
+interface WorkbenchCardComposePayloadV1 {
+  candidate: WorkbenchCardComposeCandidatePayloadV1;
+  kind: 'workbench_card_compose';
+  prompt?: string;
+  version: WorkbenchSkillPayloadVersion;
+}
+//#endregion
+//#region src/payloads/workbench-skill-payload.d.ts
+type WorkbenchSkillPayloadV1 = ChartCandidatePayloadV1 | DataActionConfirmationPayloadV1 | DataActionResultPayloadV1 | QueryClarificationPayloadV1 | QueryResultArtifactPayloadV1 | QueryTraceSummaryPayloadV1 | WorkbenchCardComposePayloadV1 | WorkbenchCardPatchPayloadV1;
+//#endregion
+//#region src/validators/payload-validator.d.ts
+type WorkbenchPayloadSchema<T extends WorkbenchSkillPayloadV1> = z.ZodType<T, z.ZodTypeDef, unknown>;
+declare const queryClarificationPayloadV1Schema: WorkbenchPayloadSchema<QueryClarificationPayloadV1>;
+declare const queryResultArtifactPayloadV1Schema: WorkbenchPayloadSchema<QueryResultArtifactPayloadV1>;
+declare const chartCandidatePayloadV1Schema: WorkbenchPayloadSchema<ChartCandidatePayloadV1>;
+declare const queryTraceSummaryPayloadV1Schema: WorkbenchPayloadSchema<QueryTraceSummaryPayloadV1>;
+declare const dataActionConfirmationPayloadV1Schema: WorkbenchPayloadSchema<DataActionConfirmationPayloadV1>;
+declare const dataActionResultPayloadV1Schema: WorkbenchPayloadSchema<DataActionResultPayloadV1>;
+declare const workbenchCardPatchPayloadV1Schema: WorkbenchPayloadSchema<WorkbenchCardPatchPayloadV1>;
+declare const workbenchCardComposePayloadV1Schema: WorkbenchPayloadSchema<WorkbenchCardComposePayloadV1>;
+declare const workbenchSkillPayloadV1Schema: WorkbenchPayloadSchema<WorkbenchSkillPayloadV1>;
+declare function validateWorkbenchSkillPayloadV1(value: unknown): QueryPayloadValidationResult<WorkbenchSkillPayloadV1>;
+declare function assertWorkbenchSkillPayloadV1(value: unknown): WorkbenchSkillPayloadV1;
+declare function isQueryClarificationPayloadV1(value: unknown): value is QueryClarificationPayloadV1;
+declare function isQueryResultArtifactPayloadV1(value: unknown): value is QueryResultArtifactPayloadV1;
+declare function isChartCandidatePayloadV1(value: unknown): value is ChartCandidatePayloadV1;
+declare function isDataActionConfirmationPayloadV1(value: unknown): value is DataActionConfirmationPayloadV1;
+declare function isDataActionResultPayloadV1(value: unknown): value is DataActionResultPayloadV1;
+declare function isQueryTraceSummaryPayloadV1(value: unknown): value is QueryTraceSummaryPayloadV1;
+declare function isWorkbenchCardPatchPayloadV1(value: unknown): value is WorkbenchCardPatchPayloadV1;
+declare function isWorkbenchCardComposePayloadV1(value: unknown): value is WorkbenchCardComposePayloadV1;
+//#endregion
+export { ChartCandidateDatasetRefV1, ChartCandidatePayloadV1, ChartCandidateType, DataActionConfirmationPayloadV1, DataActionDraftPayloadV1, DataActionDraftStatusV1, DataActionFieldV1, DataActionResultPayloadV1, QueryClarificationAnswerMode, QueryClarificationOptionV1, QueryClarificationPayloadV1, QueryClarificationRequestType, QueryDomain, QueryExecutionSource, QueryExecutionStatus, QueryPayloadIssue, QueryPayloadValidationFailure, QueryPayloadValidationResult, QueryPayloadValidationSuccess, QueryResultArtifactPayloadV1, QueryResultColumnV1, QueryResultEvidenceCoverageV1, QueryResultEvidenceExecutionSourceV1, QueryResultEvidenceExecutionStatusV1, QueryResultEvidenceSourceV1, QueryResultEvidenceStalenessV1, QueryResultEvidenceSummaryV1, QueryResultExecutionV1, QueryResultFailureReasonCodeV1, QueryTraceSummaryPayloadV1, QueryTraceSummaryStepV1, WORKBENCH_SKILL_PAYLOAD_VERSION, WorkbenchCardComposeCandidatePayloadV1, WorkbenchCardComposePayloadV1, WorkbenchCardLayoutPayloadV1, WorkbenchCardPatchItemV1, WorkbenchCardPatchMergeModeV1, WorkbenchCardPatchOperationV1, WorkbenchCardPatchPayloadV1, WorkbenchCardPatchPlanPayloadV1, WorkbenchCardPatchRiskLevelV1, WorkbenchCardPatchScopeV1, WorkbenchSkillPayloadV1, WorkbenchSkillPayloadVersion, assertWorkbenchSkillPayloadV1, chartCandidatePayloadV1Schema, dataActionConfirmationPayloadV1Schema, dataActionResultPayloadV1Schema, isChartCandidatePayloadV1, isDataActionConfirmationPayloadV1, isDataActionResultPayloadV1, isQueryClarificationPayloadV1, isQueryResultArtifactPayloadV1, isQueryTraceSummaryPayloadV1, isWorkbenchCardComposePayloadV1, isWorkbenchCardPatchPayloadV1, queryClarificationPayloadV1Schema, queryResultArtifactPayloadV1Schema, queryTraceSummaryPayloadV1Schema, validateWorkbenchSkillPayloadV1, workbenchCardComposePayloadV1Schema, workbenchCardPatchPayloadV1Schema, workbenchSkillPayloadV1Schema };

package/node_modules/@byteluck/workbench-skill-contracts/dist/index.mjs

@@ -0,0 +1,394 @@
+import { z } from "zod";
+//#region src/payloads/common.ts
+/**
+* @fileoverview Common workbench skill payload contracts - shared query payload primitives.
+* @author seadon
+* @created 2026-06-16
+*/
+const WORKBENCH_SKILL_PAYLOAD_VERSION = 1;
+//#endregion
+//#region src/validators/payload-validator.ts
+/**
+* @fileoverview Workbench skill payload validators - validates shared query domain payloads at runtime.
+* @author seadon
+* @created 2026-06-16
+*/
+/**
+* 给公开 payload schema 增加稳定的类型锚点。
+*
+* 运行时仍然使用原始 ZodObject / discriminatedUnion 做真实校验；这里的桥接只解决
+* 不同消费者 tsconfig 下 zod 对 object 输出类型推断偏宽的问题，避免下游把必填字段
+* 误判为 optional。
+* @param schema - Runtime Zod schema.
+* @returns Schema with the canonical public payload type.
+*/
+function asWorkbenchPayloadSchema(schema) {
+	return schema;
+}
+const versionSchema = z.literal(1);
+const domainSchema = z.enum([
+	"semantic_sql",
+	"runtime_metric",
+	"query_result",
+	"workbench"
+]);
+const executionStatusSchema = z.enum([
+	"blocked",
+	"failed",
+	"running",
+	"succeeded"
+]);
+const workbenchCardPatchItemSchema = z.object({
+	blockId: z.string().min(1).optional(),
+	mergeMode: z.enum([
+		"arrayMergeById",
+		"arrayMergeByType",
+		"deepMerge",
+		"replace"
+	]),
+	path: z.string().min(1),
+	reason: z.string().min(1),
+	value: z.any()
+});
+const workbenchCardPatchPlanSchema = z.object({
+	operation: z.enum([
+		"delete_card",
+		"patch_common_style",
+		"patch_echarts",
+		"patch_mixed",
+		"patch_style",
+		"regenerate_card"
+	]),
+	patches: z.array(workbenchCardPatchItemSchema),
+	requiresConfirmation: z.boolean(),
+	riskLevel: z.enum([
+		"high",
+		"low",
+		"medium"
+	]),
+	scope: z.enum([
+		"all",
+		"global_common",
+		"group",
+		"single"
+	]),
+	summary: z.string().min(1),
+	targetBlockIds: z.array(z.string().min(1)),
+	targetSummary: z.string().min(1),
+	warnings: z.array(z.string())
+});
+const workbenchCardLayoutSchema = z.object({
+	h: z.number().nonnegative(),
+	w: z.number().nonnegative(),
+	x: z.number().nonnegative(),
+	y: z.number().nonnegative()
+});
+const dataActionDraftStatusSchema = z.enum([
+	"cancelled",
+	"collecting_fields",
+	"executing",
+	"failed",
+	"matched",
+	"permission_checked",
+	"success",
+	"waiting_confirmation"
+]);
+const dataActionFieldSchema = z.object({
+	code: z.string().min(1),
+	name: z.string().min(1),
+	required: z.boolean().optional(),
+	type: z.string().min(1).optional()
+});
+const dataActionDraftSchema = z.object({
+	actionCode: z.string().min(1),
+	actionName: z.string().min(1),
+	appId: z.string().min(1),
+	confirmationRequired: z.boolean(),
+	draftId: z.string().min(1),
+	missingFields: z.array(dataActionFieldSchema),
+	modelCode: z.string().min(1),
+	saveDatas: z.record(z.unknown()),
+	sideEffectType: z.string().min(1),
+	status: dataActionDraftStatusSchema
+});
+const queryClarificationPayloadV1RawSchema = z.object({
+	answerMode: z.enum([
+		"natural_language",
+		"single_choice",
+		"multiple_choice",
+		"form"
+	]),
+	domain: domainSchema.optional(),
+	kind: z.literal("query_clarification"),
+	options: z.array(z.object({
+		description: z.string().min(1).optional(),
+		id: z.string().min(1),
+		label: z.string().min(1)
+	})).optional(),
+	question: z.string().min(1),
+	requestType: z.enum([
+		"application_selection",
+		"field_selection",
+		"metric_selection",
+		"model_selection",
+		"parameter_fill",
+		"scope_confirmation"
+	]),
+	version: versionSchema
+});
+const queryClarificationPayloadV1Schema = asWorkbenchPayloadSchema(queryClarificationPayloadV1RawSchema);
+const queryResultArtifactPayloadV1RawSchema = z.object({
+	columns: z.array(z.object({
+		key: z.string().min(1),
+		label: z.string().min(1),
+		type: z.string().min(1).optional()
+	})).min(1),
+	evidence: z.object({
+		artifactId: z.string().min(1).optional(),
+		bindingId: z.string().min(1).optional(),
+		coverage: z.enum([
+			"preview_only",
+			"full_result_ref",
+			"unavailable"
+		]),
+		evidence: z.object({ source: z.enum(["semantic_sql", "runtime_metric"]) }).strict(),
+		execution: z.object({
+			elapsedMs: z.number().nonnegative().optional(),
+			source: z.enum(["metric_execute", "sql_execute"]),
+			status: z.enum([
+				"blocked",
+				"failed",
+				"success"
+			])
+		}).strict(),
+		failureReasonCode: z.enum([
+			"SEMANTIC_CONTEXT_REQUIRED",
+			"SEMANTIC_CONTEXT_UNAVAILABLE",
+			"SQL_EXECUTION_FAILED",
+			"QUERY_RESULT_UNPARSEABLE",
+			"QUERY_RESULT_EMPTY",
+			"QUERY_RESULT_STALE",
+			"CARD_QUERY_REQUIRED",
+			"CARD_BINDING_REFRESH_FAILED",
+			"PRIVATE_CONTEXT_UNAVAILABLE"
+		]).optional(),
+		resultId: z.string().min(1),
+		rowCount: z.number().int().nonnegative().optional(),
+		sourceTurnId: z.string().min(1),
+		staleness: z.enum([
+			"fresh",
+			"stale",
+			"unknown"
+		])
+	}).strict().optional(),
+	execution: z.object({
+		elapsedMs: z.number().nonnegative().optional(),
+		source: z.enum([
+			"metric_execute",
+			"model_query",
+			"sql_execute"
+		]),
+		status: executionStatusSchema.optional()
+	}),
+	kind: z.literal("query_result"),
+	rowCount: z.number().int().nonnegative().optional(),
+	rowsPreview: z.array(z.record(z.unknown())),
+	title: z.string().min(1),
+	version: versionSchema
+});
+const queryResultArtifactPayloadV1Schema = asWorkbenchPayloadSchema(queryResultArtifactPayloadV1RawSchema);
+const chartCandidatePayloadV1RawSchema = z.object({
+	chartType: z.enum([
+		"area",
+		"bar",
+		"line",
+		"pie",
+		"scatter",
+		"table"
+	]),
+	dataset: z.object({
+		artifactId: z.string().min(1).optional(),
+		sourcePayloadKind: z.literal("query_result")
+	}),
+	dimensions: z.array(z.string().min(1)),
+	kind: z.literal("chart_candidate"),
+	measures: z.array(z.string().min(1)),
+	title: z.string().min(1),
+	version: versionSchema
+});
+const chartCandidatePayloadV1Schema = asWorkbenchPayloadSchema(chartCandidatePayloadV1RawSchema);
+const queryTraceSummaryPayloadV1RawSchema = z.object({
+	kind: z.literal("query_trace_summary"),
+	steps: z.array(z.object({
+		elapsedMs: z.number().nonnegative().optional(),
+		id: z.string().min(1),
+		label: z.string().min(1),
+		status: executionStatusSchema
+	})),
+	version: versionSchema
+});
+const queryTraceSummaryPayloadV1Schema = asWorkbenchPayloadSchema(queryTraceSummaryPayloadV1RawSchema);
+const dataActionConfirmationPayloadV1RawSchema = z.object({
+	draft: dataActionDraftSchema,
+	kind: z.literal("data_action_confirmation"),
+	prompt: z.string().min(1),
+	version: versionSchema
+});
+const dataActionConfirmationPayloadV1Schema = asWorkbenchPayloadSchema(dataActionConfirmationPayloadV1RawSchema);
+const dataActionResultPayloadV1RawSchema = z.object({
+	draft: dataActionDraftSchema,
+	error: z.object({
+		code: z.string().min(1).optional(),
+		message: z.string().min(1),
+		type: z.string().min(1).optional()
+	}).optional(),
+	kind: z.literal("data_action_result"),
+	result: z.object({
+		code: z.string().optional(),
+		data: z.unknown().optional(),
+		message: z.string().optional(),
+		state: z.string().optional()
+	}).optional(),
+	status: z.enum([
+		"cancelled",
+		"failed",
+		"success"
+	]),
+	version: versionSchema
+});
+const dataActionResultPayloadV1Schema = asWorkbenchPayloadSchema(dataActionResultPayloadV1RawSchema);
+const workbenchCardPatchPayloadV1RawSchema = z.object({
+	kind: z.literal("workbench_card_patch"),
+	patchPlan: workbenchCardPatchPlanSchema,
+	prompt: z.string().min(1).optional(),
+	version: versionSchema
+});
+const workbenchCardPatchPayloadV1Schema = asWorkbenchPayloadSchema(workbenchCardPatchPayloadV1RawSchema);
+const workbenchCardComposePayloadV1RawSchema = z.object({
+	candidate: z.object({
+		bodyJson: z.record(z.unknown()),
+		capabilityId: z.string().min(1),
+		layout: workbenchCardLayoutSchema,
+		subtitle: z.string().min(1).optional(),
+		title: z.string().min(1)
+	}),
+	kind: z.literal("workbench_card_compose"),
+	prompt: z.string().min(1).optional(),
+	version: versionSchema
+});
+const workbenchCardComposePayloadV1Schema = asWorkbenchPayloadSchema(workbenchCardComposePayloadV1RawSchema);
+const workbenchSkillPayloadV1Schema = asWorkbenchPayloadSchema(z.discriminatedUnion("kind", [
+	chartCandidatePayloadV1RawSchema,
+	dataActionConfirmationPayloadV1RawSchema,
+	dataActionResultPayloadV1RawSchema,
+	queryClarificationPayloadV1RawSchema,
+	queryResultArtifactPayloadV1RawSchema,
+	queryTraceSummaryPayloadV1RawSchema,
+	workbenchCardComposePayloadV1RawSchema,
+	workbenchCardPatchPayloadV1RawSchema
+]));
+/**
+* Converts Zod issues into a stable public validation issue shape.
+* @param issues - Zod validation issues.
+* @returns Stable validation issues with dot paths.
+*/
+function toPayloadIssues(issues) {
+	return issues.map((issue) => ({
+		message: issue.message,
+		path: issue.path.length > 0 ? issue.path.join(".") : "<root>"
+	}));
+}
+/**
+* Validates an unknown value as a first-stage workbench skill payload.
+* @param value - Unknown payload value.
+* @returns Structured validation result.
+*/
+function validateWorkbenchSkillPayloadV1(value) {
+	const result = workbenchSkillPayloadV1Schema.safeParse(value);
+	if (result.success) return {
+		ok: true,
+		value: result.data
+	};
+	return {
+		issues: toPayloadIssues(result.error.issues),
+		ok: false
+	};
+}
+/**
+* Asserts an unknown value is a first-stage workbench skill payload.
+* @param value - Unknown payload value.
+* @returns Validated payload.
+* @throws Error when the payload fails validation.
+*/
+function assertWorkbenchSkillPayloadV1(value) {
+	const result = validateWorkbenchSkillPayloadV1(value);
+	if (result.ok === true) return result.value;
+	const details = result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ");
+	throw new Error(`Workbench skill payload validation failed: ${details}`);
+}
+/**
+* Checks whether a value is a query clarification payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches QueryClarificationPayloadV1.
+*/
+function isQueryClarificationPayloadV1(value) {
+	return queryClarificationPayloadV1Schema.safeParse(value).success;
+}
+/**
+* Checks whether a value is a query result artifact payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches QueryResultArtifactPayloadV1.
+*/
+function isQueryResultArtifactPayloadV1(value) {
+	return queryResultArtifactPayloadV1Schema.safeParse(value).success;
+}
+/**
+* Checks whether a value is a chart candidate payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches ChartCandidatePayloadV1.
+*/
+function isChartCandidatePayloadV1(value) {
+	return chartCandidatePayloadV1Schema.safeParse(value).success;
+}
+/**
+* Checks whether a value is a data-action confirmation payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches DataActionConfirmationPayloadV1.
+*/
+function isDataActionConfirmationPayloadV1(value) {
+	return dataActionConfirmationPayloadV1Schema.safeParse(value).success;
+}
+/**
+* Checks whether a value is a data-action result payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches DataActionResultPayloadV1.
+*/
+function isDataActionResultPayloadV1(value) {
+	return dataActionResultPayloadV1Schema.safeParse(value).success;
+}
+/**
+* Checks whether a value is a query trace summary payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches QueryTraceSummaryPayloadV1.
+*/
+function isQueryTraceSummaryPayloadV1(value) {
+	return queryTraceSummaryPayloadV1Schema.safeParse(value).success;
+}
+/**
+* Checks whether a value is a workbench card patch payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches WorkbenchCardPatchPayloadV1.
+*/
+function isWorkbenchCardPatchPayloadV1(value) {
+	return workbenchCardPatchPayloadV1Schema.safeParse(value).success;
+}
+/**
+* Checks whether a value is a workbench card compose payload.
+* @param value - Unknown payload value.
+* @returns Whether the value matches WorkbenchCardComposePayloadV1.
+*/
+function isWorkbenchCardComposePayloadV1(value) {
+	return workbenchCardComposePayloadV1Schema.safeParse(value).success;
+}
+//#endregion
+export { WORKBENCH_SKILL_PAYLOAD_VERSION, assertWorkbenchSkillPayloadV1, chartCandidatePayloadV1Schema, dataActionConfirmationPayloadV1Schema, dataActionResultPayloadV1Schema, isChartCandidatePayloadV1, isDataActionConfirmationPayloadV1, isDataActionResultPayloadV1, isQueryClarificationPayloadV1, isQueryResultArtifactPayloadV1, isQueryTraceSummaryPayloadV1, isWorkbenchCardComposePayloadV1, isWorkbenchCardPatchPayloadV1, queryClarificationPayloadV1Schema, queryResultArtifactPayloadV1Schema, queryTraceSummaryPayloadV1Schema, validateWorkbenchSkillPayloadV1, workbenchCardComposePayloadV1Schema, workbenchCardPatchPayloadV1Schema, workbenchSkillPayloadV1Schema };