@zk-tech/ag-ui-core 0.0.1-alpha.1 → 0.0.1-alpha.10

package/README.md

@@ -1,24 +1,43 @@
-# lv-bedrock
+# @zk-tech/ag-ui-core
 
-## Get Started
+Extends from AG-UI core with more strict types and project-specific utilities.
 
-按开发环境的要求，运行和调试项目
+## Development Setup
 
-运行和调试组件
+### Using npm link for local development
 
-```
-pnpm run dev
-```
+1. **Build the package:**
+   ```bash
+   cd web-package/packages/ag-ui-core
+   pnpm build
+   ```
 
-按照社区规范和最佳实践，生成构建产物
+2. **Create npm link:**
+   ```bash
+   npm link
+   ```
 
-```
-pnpm run build
-```
+3. **Link in consuming project:**
+   ```bash
+   cd ../../../zk-web
+   npm link @zk-tech/ag-ui-core
+   ```
 
-继续创建更多项目要素
+4. **Unlink when done (optional):**
+   ```bash
+   # In consuming project
+   npm unlink @zk-tech/ag-ui-core
+   
+   # In package directory
+   npm unlink
+   ```
 
-```
-pnpm run new
-```
+## Usage
 
+```typescript
+import { createProjectContext } from '@zk-tech/ag-ui-core/utils';
+import { DesignProjectCtxNamespace, type DesignProjectProjectCtx } from '@zk-tech/ag-ui-core/protocol';
+
+// Create project context
+const context = createProjectContext('project-id-123');
+```

package/dist/context-CRBz7KR8.d.cts

@@ -0,0 +1,17 @@
+declare enum DesignProjectCtxNamespace {
+    Project = "project"
+}
+interface DesignProjectProjectCtx {
+    projectId: string;
+    /** 草稿版本号, 如果没有那么则传递 undefined */
+    workspaceHash: string | undefined;
+}
+declare enum AgentConfigCtxNamespace {
+    Config = "agent-config"
+}
+interface AgentConfigCtx {
+    /** 模型类型，对应 ModelType 枚举值 */
+    modelType: number;
+}
+
+export { AgentConfigCtxNamespace as A, DesignProjectCtxNamespace as D, type DesignProjectProjectCtx as a, type AgentConfigCtx as b };

package/dist/context-CRBz7KR8.d.ts

@@ -0,0 +1,17 @@
+declare enum DesignProjectCtxNamespace {
+    Project = "project"
+}
+interface DesignProjectProjectCtx {
+    projectId: string;
+    /** 草稿版本号, 如果没有那么则传递 undefined */
+    workspaceHash: string | undefined;
+}
+declare enum AgentConfigCtxNamespace {
+    Config = "agent-config"
+}
+interface AgentConfigCtx {
+    /** 模型类型，对应 ModelType 枚举值 */
+    modelType: number;
+}
+
+export { AgentConfigCtxNamespace as A, DesignProjectCtxNamespace as D, type DesignProjectProjectCtx as a, type AgentConfigCtx as b };

package/dist/index.cjs

@@ -1,11 +1,87 @@
 'use strict';
 
+var zod = require('zod');
+
 // src/protocol/context.ts
 var DesignProjectCtxNamespace = /* @__PURE__ */ ((DesignProjectCtxNamespace2) => {
   DesignProjectCtxNamespace2["Project"] = "project";
   return DesignProjectCtxNamespace2;
 })(DesignProjectCtxNamespace || {});
+var AgentConfigCtxNamespace = /* @__PURE__ */ ((AgentConfigCtxNamespace2) => {
+  AgentConfigCtxNamespace2["Config"] = "agent-config";
+  return AgentConfigCtxNamespace2;
+})(AgentConfigCtxNamespace || {});
+function isAssistantContentParts(content) {
+  return Array.isArray(content);
+}
+function isAssistantMessageWithParts(msg) {
+  return msg.role === "assistant" && Array.isArray(msg.content);
+}
+var AssistantMessageMetadataSchema = zod.z.object({
+  runId: zod.z.string().optional(),
+  parentRunId: zod.z.string().optional(),
+  traceUrl: zod.z.string().optional()
+});
+
+// src/utils/is-project-ctx.ts
+function isDesignProjectProjectCtx(value) {
+  return typeof value === "object" && value !== null && "projectId" in value && typeof value.projectId === "string" && value.projectId.length > 0;
+}
+
+// src/utils/create-project-context.ts
+function createProjectContext(ctx) {
+  return {
+    description: "project" /* Project */,
+    value: JSON.stringify(ctx)
+  };
+}
+
+// src/utils/extract-workspace-hash-from-context.ts
+function extractWorkspaceHashFromContext(context) {
+  if (!context || !Array.isArray(context)) {
+    return void 0;
+  }
+  for (const ctx of context) {
+    if (!ctx || typeof ctx !== "object") {
+      continue;
+    }
+    const namespace = ctx.description;
+    if (namespace === "project" /* Project */ && ctx.value) {
+      try {
+        const parsed = typeof ctx.value === "string" ? JSON.parse(ctx.value) : ctx.value;
+        if (isDesignProjectProjectCtx(parsed)) {
+          return parsed.workspaceHash;
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+  return void 0;
+}
+
+// src/utils/is-agent-config-ctx.ts
+function isAgentConfigCtx(value) {
+  return typeof value === "object" && value !== null && "modelType" in value && typeof value.modelType === "number";
+}
+
+// src/utils/create-agent-config-context.ts
+function createAgentConfigContext(ctx) {
+  return {
+    description: "agent-config" /* Config */,
+    value: JSON.stringify(ctx)
+  };
+}
 
+exports.AgentConfigCtxNamespace = AgentConfigCtxNamespace;
+exports.AssistantMessageMetadataSchema = AssistantMessageMetadataSchema;
 exports.DesignProjectCtxNamespace = DesignProjectCtxNamespace;
+exports.createAgentConfigContext = createAgentConfigContext;
+exports.createProjectContext = createProjectContext;
+exports.extractWorkspaceHashFromContext = extractWorkspaceHashFromContext;
+exports.isAgentConfigCtx = isAgentConfigCtx;
+exports.isAssistantContentParts = isAssistantContentParts;
+exports.isAssistantMessageWithParts = isAssistantMessageWithParts;
+exports.isDesignProjectProjectCtx = isDesignProjectProjectCtx;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/protocol/context.ts"],"names":["DesignProjectCtxNamespace"],"mappings":";;;AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA","file":"index.cjs","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n}"]}
+{"version":3,"sources":["../src/protocol/context.ts","../src/protocol/message.ts","../src/utils/is-project-ctx.ts","../src/utils/create-project-context.ts","../src/utils/extract-workspace-hash-from-context.ts","../src/utils/is-agent-config-ctx.ts","../src/utils/create-agent-config-context.ts"],"names":["DesignProjectCtxNamespace","AgentConfigCtxNamespace","z"],"mappings":";;;;;AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA;AAWL,IAAK,uBAAA,qBAAAC,wBAAAA,KAAL;AAEH,EAAAA,yBAAA,QAAA,CAAA,GAAS,cAAA;AAFD,EAAA,OAAAA,wBAAAA;AAAA,CAAA,EAAA,uBAAA,IAAA,EAAA;ACyCL,SAAS,wBACd,OAAA,EACmC;AACnC,EAAA,OAAO,KAAA,CAAM,QAAQ,OAAO,CAAA;AAC9B;AAaO,SAAS,4BACd,GAAA,EAC6E;AAC7E,EAAA,OAAO,IAAI,IAAA,KAAS,WAAA,IAAe,KAAA,CAAM,OAAA,CAAQ,IAAI,OAAO,CAAA;AAC9D;AAMO,IAAM,8BAAA,GAAiCC,MAAE,MAAA,CAAO;AAAA,EACrD,KAAA,EAAOA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,WAAA,EAAaA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,QAAA,EAAUA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACvB,CAAC;;;AC/EM,SAAS,0BAA0B,KAAA,EAAkD;AACxF,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA,IACvD,KAAA,CAAkC,UAAU,MAAA,GAAS,CAAA;AAE1D;;;ACDK,SAAS,qBAAqB,GAAA,EAAuC;AAE1E,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,SAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF;;;ACJO,SAAS,gCACd,OAAA,EACoB;AACpB,EAAA,IAAI,CAAC,OAAA,IAAW,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AACvC,IAAA,OAAO,MAAA;AAAA,EACT;AAGA,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,IAAI,CAAC,GAAA,IAAO,OAAO,GAAA,KAAQ,QAAA,EAAU;AACnC,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,YAAY,GAAA,CAAI,WAAA;AACtB,IAAA,IAAI,SAAA,KAAA,SAAA,kBAAmD,IAAI,KAAA,EAAO;AAChE,MAAA,IAAI;AAEF,QAAA,MAAM,MAAA,GAAS,OAAO,GAAA,CAAI,KAAA,KAAU,QAAA,GAAW,KAAK,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,GAAI,GAAA,CAAI,KAAA;AAG3E,QAAA,IAAI,yBAAA,CAA0B,MAAM,CAAA,EAAG;AACrC,UAAA,OAAO,MAAA,CAAO,aAAA;AAAA,QAChB;AAAA,MACF,CAAA,CAAA,MAAQ;AAEN,QAAA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;ACzCO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OACE,OAAO,UAAU,QAAA,IACjB,KAAA,KAAU,QACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA;AAE5D;;;ACAO,SAAS,yBAAyB,GAAA,EAA8B;AACrE,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,cAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF","file":"index.cjs","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n    /** 草稿版本号, 如果没有那么则传递 undefined */\n    workspaceHash: string | undefined;\n}\n\nexport enum AgentConfigCtxNamespace {\n    // Agent 配置相关上下文\n    Config = 'agent-config',\n}\n\nexport interface AgentConfigCtx {\n    /** 模型类型，对应 ModelType 枚举值 */\n    modelType: number;\n}\n","import { z } from \"zod\";\nimport type { Message as BaseMessage } from \"@ag-ui/core\";\n\n/**\n * Assistant message content part: thinking (reasoning) block.\n */\nexport interface AssistantContentPartThinking {\n  type: \"thinking\";\n  text: string;\n}\n\n/**\n * Assistant message content part: main answer text.\n */\nexport interface AssistantContentPartAnswer {\n  type: \"answer\";\n  text: string;\n}\n\n/**\n * Assistant message content part: inspire questions.\n */\nexport interface AssistantContentPartInspireQuestions {\n  type: \"inspire_questions\";\n  questions: string[];\n}\n\n/**\n * Assistant message content part: ask to continue prompt.\n */\nexport interface AssistantContentPartAskToContinue {\n  type: \"ask_to_continue\";\n  text: string;\n}\n\n/**\n * Discriminated union of all assistant content part types.\n */\nexport type AssistantContentPart =\n  | AssistantContentPartThinking\n  | AssistantContentPartAnswer\n  | AssistantContentPartInspireQuestions\n  | AssistantContentPartAskToContinue;\n\n/**\n * Assistant message content: either plain string (legacy/compat) or structured parts.\n * When string, treat as normal LLM response.\n */\nexport type AssistantMessageContent = string | AssistantContentPart[];\n\n/**\n * Type guard: content is array of parts (not plain string).\n */\nexport function isAssistantContentParts(\n  content: AssistantMessageContent\n): content is AssistantContentPart[] {\n  return Array.isArray(content);\n}\n\n/**\n * Message with extended assistant content (string | AssistantContentPart[]).\n * Other roles keep content as string; assistant may use AssistantMessageContent.\n */\nexport type Message =\n  | (BaseMessage & { role: \"assistant\"; content: AssistantMessageContent })\n  | (BaseMessage & { role?: \"user\" | \"tool\" | \"system\" });\n\n/**\n * Type guard: message is assistant with content parts.\n */\nexport function isAssistantMessageWithParts(\n  msg: Message\n): msg is BaseMessage & { role: \"assistant\"; content: AssistantContentPart[] } {\n  return msg.role === \"assistant\" && Array.isArray(msg.content);\n}\n\n/**\n * Metadata for assistant messages (business fields only).\n * Content semantics (thinking, inspire_questions, etc.) live in message.content as AssistantContentPart[].\n */\nexport const AssistantMessageMetadataSchema = z.object({\n  runId: z.string().optional(),\n  parentRunId: z.string().optional(),\n  traceUrl: z.string().optional(),\n});\n\nexport type AssistantMessageMetadata = z.infer<typeof AssistantMessageMetadataSchema>;\n","/**\n * Type guard to check if an object matches DesignProjectProjectCtx\n */\nimport { type DesignProjectProjectCtx } from '../protocol';\n\nexport function isDesignProjectProjectCtx(value: unknown): value is DesignProjectProjectCtx {\n    return (\n      typeof value === 'object' &&\n      value !== null &&\n      'projectId' in value &&\n      typeof (value as Record<string, unknown>).projectId === 'string' &&\n      (value as DesignProjectProjectCtx).projectId.length > 0\n    );\n  }\n  ","/**\n * Create project context for AG-UI RunAgentInput\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create a project context item for AG-UI RunAgentInput\n *\n * @param projectId - The project ID\n * @returns Context item with namespace 'project' and projectId in value\n */\nexport function createProjectContext(ctx: DesignProjectProjectCtx): Context {\n  // const projectCtx: DesignProjectProjectCtx = { projectId, workspaceHash };\n  return {\n    description: DesignProjectCtxNamespace.Project,\n    value: JSON.stringify(ctx),\n  };\n}\n","/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport { isDesignProjectProjectCtx } from './is-project-ctx';\n\n/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n *\n * @param context - Context array from RunAgentInput\n * @returns workspaceHash if found, undefined otherwise\n */\nexport function extractWorkspaceHashFromContext(\n  context: Array<{ description?: string; value?: string }> | undefined\n): string | undefined {\n  if (!context || !Array.isArray(context)) {\n    return undefined;\n  }\n\n  // Look for context with namespace 'project'\n  for (const ctx of context) {\n    if (!ctx || typeof ctx !== 'object') {\n      continue;\n    }\n\n    // Check if this is a project context (namespace = 'project')\n    const namespace = ctx.description;\n    if (namespace === DesignProjectCtxNamespace.Project && ctx.value) {\n      try {\n        // Parse value as JSON (AG-UI Context.value is a string)\n        const parsed = typeof ctx.value === 'string' ? JSON.parse(ctx.value) : ctx.value;\n\n        // Use type guard to validate and extract workspaceHash with proper typing\n        if (isDesignProjectProjectCtx(parsed)) {\n          return parsed.workspaceHash;\n        }\n      } catch {\n        // Invalid JSON, skip this context\n        continue;\n      }\n    }\n  }\n\n  return undefined;\n}","/**\n * Type guard to check if an object matches AgentConfigCtx\n */\nimport { type AgentConfigCtx } from '../protocol';\n\nexport function isAgentConfigCtx(value: unknown): value is AgentConfigCtx {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'modelType' in value &&\n    typeof (value as Record<string, unknown>).modelType === 'number'\n  );\n}\n","/**\n * Create agent config context for AG-UI RunAgentInput\n */\nimport { type AgentConfigCtx, AgentConfigCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create an agent config context item for AG-UI RunAgentInput\n *\n * @param ctx - The agent config context containing modelType\n * @returns Context item with namespace 'agent-config' and modelType in value\n */\nexport function createAgentConfigContext(ctx: AgentConfigCtx): Context {\n  return {\n    description: AgentConfigCtxNamespace.Config,\n    value: JSON.stringify(ctx),\n  };\n}\n"]}

package/dist/index.d.cts

@@ -1 +1,5 @@
-export { DesignProjectCtxNamespace, DesignProjectProjectCtx } from './protocol/index.cjs';
+export { b as AgentConfigCtx, A as AgentConfigCtxNamespace, D as DesignProjectCtxNamespace, a as DesignProjectProjectCtx } from './context-CRBz7KR8.cjs';
+export { AssistantContentPart, AssistantContentPartAnswer, AssistantContentPartAskToContinue, AssistantContentPartInspireQuestions, AssistantContentPartThinking, AssistantMessageContent, AssistantMessageMetadata, AssistantMessageMetadataSchema, Message, ResumeOption, RunAgentInput, isAssistantContentParts, isAssistantMessageWithParts } from './protocol/index.cjs';
+export { createAgentConfigContext, createProjectContext, extractWorkspaceHashFromContext, isAgentConfigCtx, isDesignProjectProjectCtx } from './utils/index.cjs';
+import 'zod';
+import '@ag-ui/core';

package/dist/index.d.ts

@@ -1 +1,5 @@
-export { DesignProjectCtxNamespace, DesignProjectProjectCtx } from './protocol/index.js';
+export { b as AgentConfigCtx, A as AgentConfigCtxNamespace, D as DesignProjectCtxNamespace, a as DesignProjectProjectCtx } from './context-CRBz7KR8.js';
+export { AssistantContentPart, AssistantContentPartAnswer, AssistantContentPartAskToContinue, AssistantContentPartInspireQuestions, AssistantContentPartThinking, AssistantMessageContent, AssistantMessageMetadata, AssistantMessageMetadataSchema, Message, ResumeOption, RunAgentInput, isAssistantContentParts, isAssistantMessageWithParts } from './protocol/index.js';
+export { createAgentConfigContext, createProjectContext, extractWorkspaceHashFromContext, isAgentConfigCtx, isDesignProjectProjectCtx } from './utils/index.js';
+import 'zod';
+import '@ag-ui/core';

package/dist/index.js

@@ -1,9 +1,76 @@
+import { z } from 'zod';
+
 // src/protocol/context.ts
 var DesignProjectCtxNamespace = /* @__PURE__ */ ((DesignProjectCtxNamespace2) => {
   DesignProjectCtxNamespace2["Project"] = "project";
   return DesignProjectCtxNamespace2;
 })(DesignProjectCtxNamespace || {});
+var AgentConfigCtxNamespace = /* @__PURE__ */ ((AgentConfigCtxNamespace2) => {
+  AgentConfigCtxNamespace2["Config"] = "agent-config";
+  return AgentConfigCtxNamespace2;
+})(AgentConfigCtxNamespace || {});
+function isAssistantContentParts(content) {
+  return Array.isArray(content);
+}
+function isAssistantMessageWithParts(msg) {
+  return msg.role === "assistant" && Array.isArray(msg.content);
+}
+var AssistantMessageMetadataSchema = z.object({
+  runId: z.string().optional(),
+  parentRunId: z.string().optional(),
+  traceUrl: z.string().optional()
+});
+
+// src/utils/is-project-ctx.ts
+function isDesignProjectProjectCtx(value) {
+  return typeof value === "object" && value !== null && "projectId" in value && typeof value.projectId === "string" && value.projectId.length > 0;
+}
+
+// src/utils/create-project-context.ts
+function createProjectContext(ctx) {
+  return {
+    description: "project" /* Project */,
+    value: JSON.stringify(ctx)
+  };
+}
+
+// src/utils/extract-workspace-hash-from-context.ts
+function extractWorkspaceHashFromContext(context) {
+  if (!context || !Array.isArray(context)) {
+    return void 0;
+  }
+  for (const ctx of context) {
+    if (!ctx || typeof ctx !== "object") {
+      continue;
+    }
+    const namespace = ctx.description;
+    if (namespace === "project" /* Project */ && ctx.value) {
+      try {
+        const parsed = typeof ctx.value === "string" ? JSON.parse(ctx.value) : ctx.value;
+        if (isDesignProjectProjectCtx(parsed)) {
+          return parsed.workspaceHash;
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+  return void 0;
+}
+
+// src/utils/is-agent-config-ctx.ts
+function isAgentConfigCtx(value) {
+  return typeof value === "object" && value !== null && "modelType" in value && typeof value.modelType === "number";
+}
+
+// src/utils/create-agent-config-context.ts
+function createAgentConfigContext(ctx) {
+  return {
+    description: "agent-config" /* Config */,
+    value: JSON.stringify(ctx)
+  };
+}
 
-export { DesignProjectCtxNamespace };
+export { AgentConfigCtxNamespace, AssistantMessageMetadataSchema, DesignProjectCtxNamespace, createAgentConfigContext, createProjectContext, extractWorkspaceHashFromContext, isAgentConfigCtx, isAssistantContentParts, isAssistantMessageWithParts, isDesignProjectProjectCtx };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/protocol/context.ts"],"names":["DesignProjectCtxNamespace"],"mappings":";AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA","file":"index.js","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n}"]}
+{"version":3,"sources":["../src/protocol/context.ts","../src/protocol/message.ts","../src/utils/is-project-ctx.ts","../src/utils/create-project-context.ts","../src/utils/extract-workspace-hash-from-context.ts","../src/utils/is-agent-config-ctx.ts","../src/utils/create-agent-config-context.ts"],"names":["DesignProjectCtxNamespace","AgentConfigCtxNamespace"],"mappings":";;;AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA;AAWL,IAAK,uBAAA,qBAAAC,wBAAAA,KAAL;AAEH,EAAAA,yBAAA,QAAA,CAAA,GAAS,cAAA;AAFD,EAAA,OAAAA,wBAAAA;AAAA,CAAA,EAAA,uBAAA,IAAA,EAAA;ACyCL,SAAS,wBACd,OAAA,EACmC;AACnC,EAAA,OAAO,KAAA,CAAM,QAAQ,OAAO,CAAA;AAC9B;AAaO,SAAS,4BACd,GAAA,EAC6E;AAC7E,EAAA,OAAO,IAAI,IAAA,KAAS,WAAA,IAAe,KAAA,CAAM,OAAA,CAAQ,IAAI,OAAO,CAAA;AAC9D;AAMO,IAAM,8BAAA,GAAiC,EAAE,MAAA,CAAO;AAAA,EACrD,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACvB,CAAC;;;AC/EM,SAAS,0BAA0B,KAAA,EAAkD;AACxF,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA,IACvD,KAAA,CAAkC,UAAU,MAAA,GAAS,CAAA;AAE1D;;;ACDK,SAAS,qBAAqB,GAAA,EAAuC;AAE1E,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,SAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF;;;ACJO,SAAS,gCACd,OAAA,EACoB;AACpB,EAAA,IAAI,CAAC,OAAA,IAAW,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AACvC,IAAA,OAAO,MAAA;AAAA,EACT;AAGA,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,IAAI,CAAC,GAAA,IAAO,OAAO,GAAA,KAAQ,QAAA,EAAU;AACnC,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,YAAY,GAAA,CAAI,WAAA;AACtB,IAAA,IAAI,SAAA,KAAA,SAAA,kBAAmD,IAAI,KAAA,EAAO;AAChE,MAAA,IAAI;AAEF,QAAA,MAAM,MAAA,GAAS,OAAO,GAAA,CAAI,KAAA,KAAU,QAAA,GAAW,KAAK,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,GAAI,GAAA,CAAI,KAAA;AAG3E,QAAA,IAAI,yBAAA,CAA0B,MAAM,CAAA,EAAG;AACrC,UAAA,OAAO,MAAA,CAAO,aAAA;AAAA,QAChB;AAAA,MACF,CAAA,CAAA,MAAQ;AAEN,QAAA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;ACzCO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OACE,OAAO,UAAU,QAAA,IACjB,KAAA,KAAU,QACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA;AAE5D;;;ACAO,SAAS,yBAAyB,GAAA,EAA8B;AACrE,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,cAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF","file":"index.js","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n    /** 草稿版本号, 如果没有那么则传递 undefined */\n    workspaceHash: string | undefined;\n}\n\nexport enum AgentConfigCtxNamespace {\n    // Agent 配置相关上下文\n    Config = 'agent-config',\n}\n\nexport interface AgentConfigCtx {\n    /** 模型类型，对应 ModelType 枚举值 */\n    modelType: number;\n}\n","import { z } from \"zod\";\nimport type { Message as BaseMessage } from \"@ag-ui/core\";\n\n/**\n * Assistant message content part: thinking (reasoning) block.\n */\nexport interface AssistantContentPartThinking {\n  type: \"thinking\";\n  text: string;\n}\n\n/**\n * Assistant message content part: main answer text.\n */\nexport interface AssistantContentPartAnswer {\n  type: \"answer\";\n  text: string;\n}\n\n/**\n * Assistant message content part: inspire questions.\n */\nexport interface AssistantContentPartInspireQuestions {\n  type: \"inspire_questions\";\n  questions: string[];\n}\n\n/**\n * Assistant message content part: ask to continue prompt.\n */\nexport interface AssistantContentPartAskToContinue {\n  type: \"ask_to_continue\";\n  text: string;\n}\n\n/**\n * Discriminated union of all assistant content part types.\n */\nexport type AssistantContentPart =\n  | AssistantContentPartThinking\n  | AssistantContentPartAnswer\n  | AssistantContentPartInspireQuestions\n  | AssistantContentPartAskToContinue;\n\n/**\n * Assistant message content: either plain string (legacy/compat) or structured parts.\n * When string, treat as normal LLM response.\n */\nexport type AssistantMessageContent = string | AssistantContentPart[];\n\n/**\n * Type guard: content is array of parts (not plain string).\n */\nexport function isAssistantContentParts(\n  content: AssistantMessageContent\n): content is AssistantContentPart[] {\n  return Array.isArray(content);\n}\n\n/**\n * Message with extended assistant content (string | AssistantContentPart[]).\n * Other roles keep content as string; assistant may use AssistantMessageContent.\n */\nexport type Message =\n  | (BaseMessage & { role: \"assistant\"; content: AssistantMessageContent })\n  | (BaseMessage & { role?: \"user\" | \"tool\" | \"system\" });\n\n/**\n * Type guard: message is assistant with content parts.\n */\nexport function isAssistantMessageWithParts(\n  msg: Message\n): msg is BaseMessage & { role: \"assistant\"; content: AssistantContentPart[] } {\n  return msg.role === \"assistant\" && Array.isArray(msg.content);\n}\n\n/**\n * Metadata for assistant messages (business fields only).\n * Content semantics (thinking, inspire_questions, etc.) live in message.content as AssistantContentPart[].\n */\nexport const AssistantMessageMetadataSchema = z.object({\n  runId: z.string().optional(),\n  parentRunId: z.string().optional(),\n  traceUrl: z.string().optional(),\n});\n\nexport type AssistantMessageMetadata = z.infer<typeof AssistantMessageMetadataSchema>;\n","/**\n * Type guard to check if an object matches DesignProjectProjectCtx\n */\nimport { type DesignProjectProjectCtx } from '../protocol';\n\nexport function isDesignProjectProjectCtx(value: unknown): value is DesignProjectProjectCtx {\n    return (\n      typeof value === 'object' &&\n      value !== null &&\n      'projectId' in value &&\n      typeof (value as Record<string, unknown>).projectId === 'string' &&\n      (value as DesignProjectProjectCtx).projectId.length > 0\n    );\n  }\n  ","/**\n * Create project context for AG-UI RunAgentInput\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create a project context item for AG-UI RunAgentInput\n *\n * @param projectId - The project ID\n * @returns Context item with namespace 'project' and projectId in value\n */\nexport function createProjectContext(ctx: DesignProjectProjectCtx): Context {\n  // const projectCtx: DesignProjectProjectCtx = { projectId, workspaceHash };\n  return {\n    description: DesignProjectCtxNamespace.Project,\n    value: JSON.stringify(ctx),\n  };\n}\n","/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport { isDesignProjectProjectCtx } from './is-project-ctx';\n\n/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n *\n * @param context - Context array from RunAgentInput\n * @returns workspaceHash if found, undefined otherwise\n */\nexport function extractWorkspaceHashFromContext(\n  context: Array<{ description?: string; value?: string }> | undefined\n): string | undefined {\n  if (!context || !Array.isArray(context)) {\n    return undefined;\n  }\n\n  // Look for context with namespace 'project'\n  for (const ctx of context) {\n    if (!ctx || typeof ctx !== 'object') {\n      continue;\n    }\n\n    // Check if this is a project context (namespace = 'project')\n    const namespace = ctx.description;\n    if (namespace === DesignProjectCtxNamespace.Project && ctx.value) {\n      try {\n        // Parse value as JSON (AG-UI Context.value is a string)\n        const parsed = typeof ctx.value === 'string' ? JSON.parse(ctx.value) : ctx.value;\n\n        // Use type guard to validate and extract workspaceHash with proper typing\n        if (isDesignProjectProjectCtx(parsed)) {\n          return parsed.workspaceHash;\n        }\n      } catch {\n        // Invalid JSON, skip this context\n        continue;\n      }\n    }\n  }\n\n  return undefined;\n}","/**\n * Type guard to check if an object matches AgentConfigCtx\n */\nimport { type AgentConfigCtx } from '../protocol';\n\nexport function isAgentConfigCtx(value: unknown): value is AgentConfigCtx {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'modelType' in value &&\n    typeof (value as Record<string, unknown>).modelType === 'number'\n  );\n}\n","/**\n * Create agent config context for AG-UI RunAgentInput\n */\nimport { type AgentConfigCtx, AgentConfigCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create an agent config context item for AG-UI RunAgentInput\n *\n * @param ctx - The agent config context containing modelType\n * @returns Context item with namespace 'agent-config' and modelType in value\n */\nexport function createAgentConfigContext(ctx: AgentConfigCtx): Context {\n  return {\n    description: AgentConfigCtxNamespace.Config,\n    value: JSON.stringify(ctx),\n  };\n}\n"]}

package/dist/protocol/index.cjs

@@ -1,11 +1,32 @@
 'use strict';
 
+var zod = require('zod');
+
 // src/protocol/context.ts
 var DesignProjectCtxNamespace = /* @__PURE__ */ ((DesignProjectCtxNamespace2) => {
   DesignProjectCtxNamespace2["Project"] = "project";
   return DesignProjectCtxNamespace2;
 })(DesignProjectCtxNamespace || {});
+var AgentConfigCtxNamespace = /* @__PURE__ */ ((AgentConfigCtxNamespace2) => {
+  AgentConfigCtxNamespace2["Config"] = "agent-config";
+  return AgentConfigCtxNamespace2;
+})(AgentConfigCtxNamespace || {});
+function isAssistantContentParts(content) {
+  return Array.isArray(content);
+}
+function isAssistantMessageWithParts(msg) {
+  return msg.role === "assistant" && Array.isArray(msg.content);
+}
+var AssistantMessageMetadataSchema = zod.z.object({
+  runId: zod.z.string().optional(),
+  parentRunId: zod.z.string().optional(),
+  traceUrl: zod.z.string().optional()
+});
 
+exports.AgentConfigCtxNamespace = AgentConfigCtxNamespace;
+exports.AssistantMessageMetadataSchema = AssistantMessageMetadataSchema;
 exports.DesignProjectCtxNamespace = DesignProjectCtxNamespace;
+exports.isAssistantContentParts = isAssistantContentParts;
+exports.isAssistantMessageWithParts = isAssistantMessageWithParts;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/protocol/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/protocol/context.ts"],"names":["DesignProjectCtxNamespace"],"mappings":";;;AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA","file":"index.cjs","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n}"]}
+{"version":3,"sources":["../../src/protocol/context.ts","../../src/protocol/message.ts"],"names":["DesignProjectCtxNamespace","AgentConfigCtxNamespace","z"],"mappings":";;;;;AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA;AAWL,IAAK,uBAAA,qBAAAC,wBAAAA,KAAL;AAEH,EAAAA,yBAAA,QAAA,CAAA,GAAS,cAAA;AAFD,EAAA,OAAAA,wBAAAA;AAAA,CAAA,EAAA,uBAAA,IAAA,EAAA;ACyCL,SAAS,wBACd,OAAA,EACmC;AACnC,EAAA,OAAO,KAAA,CAAM,QAAQ,OAAO,CAAA;AAC9B;AAaO,SAAS,4BACd,GAAA,EAC6E;AAC7E,EAAA,OAAO,IAAI,IAAA,KAAS,WAAA,IAAe,KAAA,CAAM,OAAA,CAAQ,IAAI,OAAO,CAAA;AAC9D;AAMO,IAAM,8BAAA,GAAiCC,MAAE,MAAA,CAAO;AAAA,EACrD,KAAA,EAAOA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,WAAA,EAAaA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,QAAA,EAAUA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACvB,CAAC","file":"index.cjs","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n    /** 草稿版本号, 如果没有那么则传递 undefined */\n    workspaceHash: string | undefined;\n}\n\nexport enum AgentConfigCtxNamespace {\n    // Agent 配置相关上下文\n    Config = 'agent-config',\n}\n\nexport interface AgentConfigCtx {\n    /** 模型类型，对应 ModelType 枚举值 */\n    modelType: number;\n}\n","import { z } from \"zod\";\nimport type { Message as BaseMessage } from \"@ag-ui/core\";\n\n/**\n * Assistant message content part: thinking (reasoning) block.\n */\nexport interface AssistantContentPartThinking {\n  type: \"thinking\";\n  text: string;\n}\n\n/**\n * Assistant message content part: main answer text.\n */\nexport interface AssistantContentPartAnswer {\n  type: \"answer\";\n  text: string;\n}\n\n/**\n * Assistant message content part: inspire questions.\n */\nexport interface AssistantContentPartInspireQuestions {\n  type: \"inspire_questions\";\n  questions: string[];\n}\n\n/**\n * Assistant message content part: ask to continue prompt.\n */\nexport interface AssistantContentPartAskToContinue {\n  type: \"ask_to_continue\";\n  text: string;\n}\n\n/**\n * Discriminated union of all assistant content part types.\n */\nexport type AssistantContentPart =\n  | AssistantContentPartThinking\n  | AssistantContentPartAnswer\n  | AssistantContentPartInspireQuestions\n  | AssistantContentPartAskToContinue;\n\n/**\n * Assistant message content: either plain string (legacy/compat) or structured parts.\n * When string, treat as normal LLM response.\n */\nexport type AssistantMessageContent = string | AssistantContentPart[];\n\n/**\n * Type guard: content is array of parts (not plain string).\n */\nexport function isAssistantContentParts(\n  content: AssistantMessageContent\n): content is AssistantContentPart[] {\n  return Array.isArray(content);\n}\n\n/**\n * Message with extended assistant content (string | AssistantContentPart[]).\n * Other roles keep content as string; assistant may use AssistantMessageContent.\n */\nexport type Message =\n  | (BaseMessage & { role: \"assistant\"; content: AssistantMessageContent })\n  | (BaseMessage & { role?: \"user\" | \"tool\" | \"system\" });\n\n/**\n * Type guard: message is assistant with content parts.\n */\nexport function isAssistantMessageWithParts(\n  msg: Message\n): msg is BaseMessage & { role: \"assistant\"; content: AssistantContentPart[] } {\n  return msg.role === \"assistant\" && Array.isArray(msg.content);\n}\n\n/**\n * Metadata for assistant messages (business fields only).\n * Content semantics (thinking, inspire_questions, etc.) live in message.content as AssistantContentPart[].\n */\nexport const AssistantMessageMetadataSchema = z.object({\n  runId: z.string().optional(),\n  parentRunId: z.string().optional(),\n  traceUrl: z.string().optional(),\n});\n\nexport type AssistantMessageMetadata = z.infer<typeof AssistantMessageMetadataSchema>;\n"]}

package/dist/protocol/index.d.cts

@@ -1,8 +1,114 @@
-declare enum DesignProjectCtxNamespace {
-    Project = "project"
+export { b as AgentConfigCtx, A as AgentConfigCtxNamespace, D as DesignProjectCtxNamespace, a as DesignProjectProjectCtx } from '../context-CRBz7KR8.cjs';
+import { z } from 'zod';
+import { Message as Message$1, RunAgentInput as RunAgentInput$1 } from '@ag-ui/core';
+
+/**
+ * Assistant message content part: thinking (reasoning) block.
+ */
+interface AssistantContentPartThinking {
+    type: "thinking";
+    text: string;
+}
+/**
+ * Assistant message content part: main answer text.
+ */
+interface AssistantContentPartAnswer {
+    type: "answer";
+    text: string;
+}
+/**
+ * Assistant message content part: inspire questions.
+ */
+interface AssistantContentPartInspireQuestions {
+    type: "inspire_questions";
+    questions: string[];
+}
+/**
+ * Assistant message content part: ask to continue prompt.
+ */
+interface AssistantContentPartAskToContinue {
+    type: "ask_to_continue";
+    text: string;
+}
+/**
+ * Discriminated union of all assistant content part types.
+ */
+type AssistantContentPart = AssistantContentPartThinking | AssistantContentPartAnswer | AssistantContentPartInspireQuestions | AssistantContentPartAskToContinue;
+/**
+ * Assistant message content: either plain string (legacy/compat) or structured parts.
+ * When string, treat as normal LLM response.
+ */
+type AssistantMessageContent = string | AssistantContentPart[];
+/**
+ * Type guard: content is array of parts (not plain string).
+ */
+declare function isAssistantContentParts(content: AssistantMessageContent): content is AssistantContentPart[];
+/**
+ * Message with extended assistant content (string | AssistantContentPart[]).
+ * Other roles keep content as string; assistant may use AssistantMessageContent.
+ */
+type Message = (Message$1 & {
+    role: "assistant";
+    content: AssistantMessageContent;
+}) | (Message$1 & {
+    role?: "user" | "tool" | "system";
+});
+/**
+ * Type guard: message is assistant with content parts.
+ */
+declare function isAssistantMessageWithParts(msg: Message): msg is Message$1 & {
+    role: "assistant";
+    content: AssistantContentPart[];
+};
+/**
+ * Metadata for assistant messages (business fields only).
+ * Content semantics (thinking, inspire_questions, etc.) live in message.content as AssistantContentPart[].
+ */
+declare const AssistantMessageMetadataSchema: z.ZodObject<{
+    runId: z.ZodOptional<z.ZodString>;
+    parentRunId: z.ZodOptional<z.ZodString>;
+    traceUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    runId?: string | undefined;
+    parentRunId?: string | undefined;
+    traceUrl?: string | undefined;
+}, {
+    runId?: string | undefined;
+    parentRunId?: string | undefined;
+    traceUrl?: string | undefined;
+}>;
+type AssistantMessageMetadata = z.infer<typeof AssistantMessageMetadataSchema>;
+
+/**
+ * RunAgentInput 类型重定义
+ * 直接使用 @ag-ui/core 的标准类型，保持协议一致性
+ */
+
+/**
+ * Resume 选项类型（用于恢复中断的运行）
+ */
+interface ResumeOption {
+    /**
+     * 中断 ID（可选，如果提供了则回显）
+     * 来自 RUN_FINISHED 事件中的 interrupt.id
+     */
+    interruptId?: string;
+    /**
+     * 用户响应数据（任意 JSON）
+     * 可以包含 approvals、edits、files-as-refs 等
+     */
+    payload?: any;
 }
-interface DesignProjectProjectCtx {
-    projectId: string;
+/**
+ * RunAgentInput 类型重定义
+ * 基于 @ag-ui/core 的标准类型，扩展 resume 字段以支持中断恢复
+ */
+interface RunAgentInput extends RunAgentInput$1 {
+    /**
+     * Resume 选项（用于恢复中断的运行）
+     * 当需要恢复一个被中断的 run 时，提供此字段
+     */
+    resume?: ResumeOption;
 }
 
-export { DesignProjectCtxNamespace, type DesignProjectProjectCtx };
+export { type AssistantContentPart, type AssistantContentPartAnswer, type AssistantContentPartAskToContinue, type AssistantContentPartInspireQuestions, type AssistantContentPartThinking, type AssistantMessageContent, type AssistantMessageMetadata, AssistantMessageMetadataSchema, type Message, type ResumeOption, type RunAgentInput, isAssistantContentParts, isAssistantMessageWithParts };

package/dist/protocol/index.d.ts

@@ -1,8 +1,114 @@
-declare enum DesignProjectCtxNamespace {
-    Project = "project"
+export { b as AgentConfigCtx, A as AgentConfigCtxNamespace, D as DesignProjectCtxNamespace, a as DesignProjectProjectCtx } from '../context-CRBz7KR8.js';
+import { z } from 'zod';
+import { Message as Message$1, RunAgentInput as RunAgentInput$1 } from '@ag-ui/core';
+
+/**
+ * Assistant message content part: thinking (reasoning) block.
+ */
+interface AssistantContentPartThinking {
+    type: "thinking";
+    text: string;
+}
+/**
+ * Assistant message content part: main answer text.
+ */
+interface AssistantContentPartAnswer {
+    type: "answer";
+    text: string;
+}
+/**
+ * Assistant message content part: inspire questions.
+ */
+interface AssistantContentPartInspireQuestions {
+    type: "inspire_questions";
+    questions: string[];
+}
+/**
+ * Assistant message content part: ask to continue prompt.
+ */
+interface AssistantContentPartAskToContinue {
+    type: "ask_to_continue";
+    text: string;
+}
+/**
+ * Discriminated union of all assistant content part types.
+ */
+type AssistantContentPart = AssistantContentPartThinking | AssistantContentPartAnswer | AssistantContentPartInspireQuestions | AssistantContentPartAskToContinue;
+/**
+ * Assistant message content: either plain string (legacy/compat) or structured parts.
+ * When string, treat as normal LLM response.
+ */
+type AssistantMessageContent = string | AssistantContentPart[];
+/**
+ * Type guard: content is array of parts (not plain string).
+ */
+declare function isAssistantContentParts(content: AssistantMessageContent): content is AssistantContentPart[];
+/**
+ * Message with extended assistant content (string | AssistantContentPart[]).
+ * Other roles keep content as string; assistant may use AssistantMessageContent.
+ */
+type Message = (Message$1 & {
+    role: "assistant";
+    content: AssistantMessageContent;
+}) | (Message$1 & {
+    role?: "user" | "tool" | "system";
+});
+/**
+ * Type guard: message is assistant with content parts.
+ */
+declare function isAssistantMessageWithParts(msg: Message): msg is Message$1 & {
+    role: "assistant";
+    content: AssistantContentPart[];
+};
+/**
+ * Metadata for assistant messages (business fields only).
+ * Content semantics (thinking, inspire_questions, etc.) live in message.content as AssistantContentPart[].
+ */
+declare const AssistantMessageMetadataSchema: z.ZodObject<{
+    runId: z.ZodOptional<z.ZodString>;
+    parentRunId: z.ZodOptional<z.ZodString>;
+    traceUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    runId?: string | undefined;
+    parentRunId?: string | undefined;
+    traceUrl?: string | undefined;
+}, {
+    runId?: string | undefined;
+    parentRunId?: string | undefined;
+    traceUrl?: string | undefined;
+}>;
+type AssistantMessageMetadata = z.infer<typeof AssistantMessageMetadataSchema>;
+
+/**
+ * RunAgentInput 类型重定义
+ * 直接使用 @ag-ui/core 的标准类型，保持协议一致性
+ */
+
+/**
+ * Resume 选项类型（用于恢复中断的运行）
+ */
+interface ResumeOption {
+    /**
+     * 中断 ID（可选，如果提供了则回显）
+     * 来自 RUN_FINISHED 事件中的 interrupt.id
+     */
+    interruptId?: string;
+    /**
+     * 用户响应数据（任意 JSON）
+     * 可以包含 approvals、edits、files-as-refs 等
+     */
+    payload?: any;
 }
-interface DesignProjectProjectCtx {
-    projectId: string;
+/**
+ * RunAgentInput 类型重定义
+ * 基于 @ag-ui/core 的标准类型，扩展 resume 字段以支持中断恢复
+ */
+interface RunAgentInput extends RunAgentInput$1 {
+    /**
+     * Resume 选项（用于恢复中断的运行）
+     * 当需要恢复一个被中断的 run 时，提供此字段
+     */
+    resume?: ResumeOption;
 }
 
-export { DesignProjectCtxNamespace, type DesignProjectProjectCtx };
+export { type AssistantContentPart, type AssistantContentPartAnswer, type AssistantContentPartAskToContinue, type AssistantContentPartInspireQuestions, type AssistantContentPartThinking, type AssistantMessageContent, type AssistantMessageMetadata, AssistantMessageMetadataSchema, type Message, type ResumeOption, type RunAgentInput, isAssistantContentParts, isAssistantMessageWithParts };

package/dist/protocol/index.js

@@ -1,9 +1,26 @@
+import { z } from 'zod';
+
 // src/protocol/context.ts
 var DesignProjectCtxNamespace = /* @__PURE__ */ ((DesignProjectCtxNamespace2) => {
   DesignProjectCtxNamespace2["Project"] = "project";
   return DesignProjectCtxNamespace2;
 })(DesignProjectCtxNamespace || {});
+var AgentConfigCtxNamespace = /* @__PURE__ */ ((AgentConfigCtxNamespace2) => {
+  AgentConfigCtxNamespace2["Config"] = "agent-config";
+  return AgentConfigCtxNamespace2;
+})(AgentConfigCtxNamespace || {});
+function isAssistantContentParts(content) {
+  return Array.isArray(content);
+}
+function isAssistantMessageWithParts(msg) {
+  return msg.role === "assistant" && Array.isArray(msg.content);
+}
+var AssistantMessageMetadataSchema = z.object({
+  runId: z.string().optional(),
+  parentRunId: z.string().optional(),
+  traceUrl: z.string().optional()
+});
 
-export { DesignProjectCtxNamespace };
+export { AgentConfigCtxNamespace, AssistantMessageMetadataSchema, DesignProjectCtxNamespace, isAssistantContentParts, isAssistantMessageWithParts };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/protocol/context.ts"],"names":["DesignProjectCtxNamespace"],"mappings":";AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA","file":"index.js","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n}"]}
+{"version":3,"sources":["../../src/protocol/context.ts","../../src/protocol/message.ts"],"names":["DesignProjectCtxNamespace","AgentConfigCtxNamespace"],"mappings":";;;AACO,IAAK,yBAAA,qBAAAA,0BAAAA,KAAL;AAEH,EAAAA,2BAAA,SAAA,CAAA,GAAU,SAAA;AAFF,EAAA,OAAAA,0BAAAA;AAAA,CAAA,EAAA,yBAAA,IAAA,EAAA;AAWL,IAAK,uBAAA,qBAAAC,wBAAAA,KAAL;AAEH,EAAAA,yBAAA,QAAA,CAAA,GAAS,cAAA;AAFD,EAAA,OAAAA,wBAAAA;AAAA,CAAA,EAAA,uBAAA,IAAA,EAAA;ACyCL,SAAS,wBACd,OAAA,EACmC;AACnC,EAAA,OAAO,KAAA,CAAM,QAAQ,OAAO,CAAA;AAC9B;AAaO,SAAS,4BACd,GAAA,EAC6E;AAC7E,EAAA,OAAO,IAAI,IAAA,KAAS,WAAA,IAAe,KAAA,CAAM,OAAA,CAAQ,IAAI,OAAO,CAAA;AAC9D;AAMO,IAAM,8BAAA,GAAiC,EAAE,MAAA,CAAO;AAAA,EACrD,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACvB,CAAC","file":"index.js","sourcesContent":["\nexport enum DesignProjectCtxNamespace {\n    // 项目相关上下文\n    Project = 'project',\n}\n\nexport interface DesignProjectProjectCtx {\n    projectId: string;\n    /** 草稿版本号, 如果没有那么则传递 undefined */\n    workspaceHash: string | undefined;\n}\n\nexport enum AgentConfigCtxNamespace {\n    // Agent 配置相关上下文\n    Config = 'agent-config',\n}\n\nexport interface AgentConfigCtx {\n    /** 模型类型，对应 ModelType 枚举值 */\n    modelType: number;\n}\n","import { z } from \"zod\";\nimport type { Message as BaseMessage } from \"@ag-ui/core\";\n\n/**\n * Assistant message content part: thinking (reasoning) block.\n */\nexport interface AssistantContentPartThinking {\n  type: \"thinking\";\n  text: string;\n}\n\n/**\n * Assistant message content part: main answer text.\n */\nexport interface AssistantContentPartAnswer {\n  type: \"answer\";\n  text: string;\n}\n\n/**\n * Assistant message content part: inspire questions.\n */\nexport interface AssistantContentPartInspireQuestions {\n  type: \"inspire_questions\";\n  questions: string[];\n}\n\n/**\n * Assistant message content part: ask to continue prompt.\n */\nexport interface AssistantContentPartAskToContinue {\n  type: \"ask_to_continue\";\n  text: string;\n}\n\n/**\n * Discriminated union of all assistant content part types.\n */\nexport type AssistantContentPart =\n  | AssistantContentPartThinking\n  | AssistantContentPartAnswer\n  | AssistantContentPartInspireQuestions\n  | AssistantContentPartAskToContinue;\n\n/**\n * Assistant message content: either plain string (legacy/compat) or structured parts.\n * When string, treat as normal LLM response.\n */\nexport type AssistantMessageContent = string | AssistantContentPart[];\n\n/**\n * Type guard: content is array of parts (not plain string).\n */\nexport function isAssistantContentParts(\n  content: AssistantMessageContent\n): content is AssistantContentPart[] {\n  return Array.isArray(content);\n}\n\n/**\n * Message with extended assistant content (string | AssistantContentPart[]).\n * Other roles keep content as string; assistant may use AssistantMessageContent.\n */\nexport type Message =\n  | (BaseMessage & { role: \"assistant\"; content: AssistantMessageContent })\n  | (BaseMessage & { role?: \"user\" | \"tool\" | \"system\" });\n\n/**\n * Type guard: message is assistant with content parts.\n */\nexport function isAssistantMessageWithParts(\n  msg: Message\n): msg is BaseMessage & { role: \"assistant\"; content: AssistantContentPart[] } {\n  return msg.role === \"assistant\" && Array.isArray(msg.content);\n}\n\n/**\n * Metadata for assistant messages (business fields only).\n * Content semantics (thinking, inspire_questions, etc.) live in message.content as AssistantContentPart[].\n */\nexport const AssistantMessageMetadataSchema = z.object({\n  runId: z.string().optional(),\n  parentRunId: z.string().optional(),\n  traceUrl: z.string().optional(),\n});\n\nexport type AssistantMessageMetadata = z.infer<typeof AssistantMessageMetadataSchema>;\n"]}

package/dist/utils/index.cjs

@@ -0,0 +1,59 @@
+'use strict';
+
+// src/utils/is-project-ctx.ts
+function isDesignProjectProjectCtx(value) {
+  return typeof value === "object" && value !== null && "projectId" in value && typeof value.projectId === "string" && value.projectId.length > 0;
+}
+
+// src/utils/create-project-context.ts
+function createProjectContext(ctx) {
+  return {
+    description: "project" /* Project */,
+    value: JSON.stringify(ctx)
+  };
+}
+
+// src/utils/extract-workspace-hash-from-context.ts
+function extractWorkspaceHashFromContext(context) {
+  if (!context || !Array.isArray(context)) {
+    return void 0;
+  }
+  for (const ctx of context) {
+    if (!ctx || typeof ctx !== "object") {
+      continue;
+    }
+    const namespace = ctx.description;
+    if (namespace === "project" /* Project */ && ctx.value) {
+      try {
+        const parsed = typeof ctx.value === "string" ? JSON.parse(ctx.value) : ctx.value;
+        if (isDesignProjectProjectCtx(parsed)) {
+          return parsed.workspaceHash;
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+  return void 0;
+}
+
+// src/utils/is-agent-config-ctx.ts
+function isAgentConfigCtx(value) {
+  return typeof value === "object" && value !== null && "modelType" in value && typeof value.modelType === "number";
+}
+
+// src/utils/create-agent-config-context.ts
+function createAgentConfigContext(ctx) {
+  return {
+    description: "agent-config" /* Config */,
+    value: JSON.stringify(ctx)
+  };
+}
+
+exports.createAgentConfigContext = createAgentConfigContext;
+exports.createProjectContext = createProjectContext;
+exports.extractWorkspaceHashFromContext = extractWorkspaceHashFromContext;
+exports.isAgentConfigCtx = isAgentConfigCtx;
+exports.isDesignProjectProjectCtx = isDesignProjectProjectCtx;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/is-project-ctx.ts","../../src/utils/create-project-context.ts","../../src/utils/extract-workspace-hash-from-context.ts","../../src/utils/is-agent-config-ctx.ts","../../src/utils/create-agent-config-context.ts"],"names":[],"mappings":";;;AAKO,SAAS,0BAA0B,KAAA,EAAkD;AACxF,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA,IACvD,KAAA,CAAkC,UAAU,MAAA,GAAS,CAAA;AAE1D;;;ACDK,SAAS,qBAAqB,GAAA,EAAuC;AAE1E,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,SAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF;;;ACJO,SAAS,gCACd,OAAA,EACoB;AACpB,EAAA,IAAI,CAAC,OAAA,IAAW,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AACvC,IAAA,OAAO,MAAA;AAAA,EACT;AAGA,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,IAAI,CAAC,GAAA,IAAO,OAAO,GAAA,KAAQ,QAAA,EAAU;AACnC,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,YAAY,GAAA,CAAI,WAAA;AACtB,IAAA,IAAI,SAAA,KAAA,SAAA,kBAAmD,IAAI,KAAA,EAAO;AAChE,MAAA,IAAI;AAEF,QAAA,MAAM,MAAA,GAAS,OAAO,GAAA,CAAI,KAAA,KAAU,QAAA,GAAW,KAAK,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,GAAI,GAAA,CAAI,KAAA;AAG3E,QAAA,IAAI,yBAAA,CAA0B,MAAM,CAAA,EAAG;AACrC,UAAA,OAAO,MAAA,CAAO,aAAA;AAAA,QAChB;AAAA,MACF,CAAA,CAAA,MAAQ;AAEN,QAAA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;ACzCO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OACE,OAAO,UAAU,QAAA,IACjB,KAAA,KAAU,QACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA;AAE5D;;;ACAO,SAAS,yBAAyB,GAAA,EAA8B;AACrE,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,cAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF","file":"index.cjs","sourcesContent":["/**\n * Type guard to check if an object matches DesignProjectProjectCtx\n */\nimport { type DesignProjectProjectCtx } from '../protocol';\n\nexport function isDesignProjectProjectCtx(value: unknown): value is DesignProjectProjectCtx {\n    return (\n      typeof value === 'object' &&\n      value !== null &&\n      'projectId' in value &&\n      typeof (value as Record<string, unknown>).projectId === 'string' &&\n      (value as DesignProjectProjectCtx).projectId.length > 0\n    );\n  }\n  ","/**\n * Create project context for AG-UI RunAgentInput\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create a project context item for AG-UI RunAgentInput\n *\n * @param projectId - The project ID\n * @returns Context item with namespace 'project' and projectId in value\n */\nexport function createProjectContext(ctx: DesignProjectProjectCtx): Context {\n  // const projectCtx: DesignProjectProjectCtx = { projectId, workspaceHash };\n  return {\n    description: DesignProjectCtxNamespace.Project,\n    value: JSON.stringify(ctx),\n  };\n}\n","/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport { isDesignProjectProjectCtx } from './is-project-ctx';\n\n/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n *\n * @param context - Context array from RunAgentInput\n * @returns workspaceHash if found, undefined otherwise\n */\nexport function extractWorkspaceHashFromContext(\n  context: Array<{ description?: string; value?: string }> | undefined\n): string | undefined {\n  if (!context || !Array.isArray(context)) {\n    return undefined;\n  }\n\n  // Look for context with namespace 'project'\n  for (const ctx of context) {\n    if (!ctx || typeof ctx !== 'object') {\n      continue;\n    }\n\n    // Check if this is a project context (namespace = 'project')\n    const namespace = ctx.description;\n    if (namespace === DesignProjectCtxNamespace.Project && ctx.value) {\n      try {\n        // Parse value as JSON (AG-UI Context.value is a string)\n        const parsed = typeof ctx.value === 'string' ? JSON.parse(ctx.value) : ctx.value;\n\n        // Use type guard to validate and extract workspaceHash with proper typing\n        if (isDesignProjectProjectCtx(parsed)) {\n          return parsed.workspaceHash;\n        }\n      } catch {\n        // Invalid JSON, skip this context\n        continue;\n      }\n    }\n  }\n\n  return undefined;\n}","/**\n * Type guard to check if an object matches AgentConfigCtx\n */\nimport { type AgentConfigCtx } from '../protocol';\n\nexport function isAgentConfigCtx(value: unknown): value is AgentConfigCtx {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'modelType' in value &&\n    typeof (value as Record<string, unknown>).modelType === 'number'\n  );\n}\n","/**\n * Create agent config context for AG-UI RunAgentInput\n */\nimport { type AgentConfigCtx, AgentConfigCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create an agent config context item for AG-UI RunAgentInput\n *\n * @param ctx - The agent config context containing modelType\n * @returns Context item with namespace 'agent-config' and modelType in value\n */\nexport function createAgentConfigContext(ctx: AgentConfigCtx): Context {\n  return {\n    description: AgentConfigCtxNamespace.Config,\n    value: JSON.stringify(ctx),\n  };\n}\n"]}

package/dist/utils/index.d.cts

@@ -0,0 +1,52 @@
+import { a as DesignProjectProjectCtx, b as AgentConfigCtx } from '../context-CRBz7KR8.cjs';
+import { Context } from '@ag-ui/core';
+
+/**
+ * Type guard to check if an object matches DesignProjectProjectCtx
+ */
+
+declare function isDesignProjectProjectCtx(value: unknown): value is DesignProjectProjectCtx;
+
+/**
+ * Create project context for AG-UI RunAgentInput
+ */
+
+/**
+ * Create a project context item for AG-UI RunAgentInput
+ *
+ * @param projectId - The project ID
+ * @returns Context item with namespace 'project' and projectId in value
+ */
+declare function createProjectContext(ctx: DesignProjectProjectCtx): Context;
+
+/**
+ * Extract workspaceHash from context array
+ * Looks for context with namespace 'project' and extracts workspaceHash from value
+ *
+ * @param context - Context array from RunAgentInput
+ * @returns workspaceHash if found, undefined otherwise
+ */
+declare function extractWorkspaceHashFromContext(context: Array<{
+    description?: string;
+    value?: string;
+}> | undefined): string | undefined;
+
+/**
+ * Type guard to check if an object matches AgentConfigCtx
+ */
+
+declare function isAgentConfigCtx(value: unknown): value is AgentConfigCtx;
+
+/**
+ * Create agent config context for AG-UI RunAgentInput
+ */
+
+/**
+ * Create an agent config context item for AG-UI RunAgentInput
+ *
+ * @param ctx - The agent config context containing modelType
+ * @returns Context item with namespace 'agent-config' and modelType in value
+ */
+declare function createAgentConfigContext(ctx: AgentConfigCtx): Context;
+
+export { createAgentConfigContext, createProjectContext, extractWorkspaceHashFromContext, isAgentConfigCtx, isDesignProjectProjectCtx };

package/dist/utils/index.d.ts

@@ -0,0 +1,52 @@
+import { a as DesignProjectProjectCtx, b as AgentConfigCtx } from '../context-CRBz7KR8.js';
+import { Context } from '@ag-ui/core';
+
+/**
+ * Type guard to check if an object matches DesignProjectProjectCtx
+ */
+
+declare function isDesignProjectProjectCtx(value: unknown): value is DesignProjectProjectCtx;
+
+/**
+ * Create project context for AG-UI RunAgentInput
+ */
+
+/**
+ * Create a project context item for AG-UI RunAgentInput
+ *
+ * @param projectId - The project ID
+ * @returns Context item with namespace 'project' and projectId in value
+ */
+declare function createProjectContext(ctx: DesignProjectProjectCtx): Context;
+
+/**
+ * Extract workspaceHash from context array
+ * Looks for context with namespace 'project' and extracts workspaceHash from value
+ *
+ * @param context - Context array from RunAgentInput
+ * @returns workspaceHash if found, undefined otherwise
+ */
+declare function extractWorkspaceHashFromContext(context: Array<{
+    description?: string;
+    value?: string;
+}> | undefined): string | undefined;
+
+/**
+ * Type guard to check if an object matches AgentConfigCtx
+ */
+
+declare function isAgentConfigCtx(value: unknown): value is AgentConfigCtx;
+
+/**
+ * Create agent config context for AG-UI RunAgentInput
+ */
+
+/**
+ * Create an agent config context item for AG-UI RunAgentInput
+ *
+ * @param ctx - The agent config context containing modelType
+ * @returns Context item with namespace 'agent-config' and modelType in value
+ */
+declare function createAgentConfigContext(ctx: AgentConfigCtx): Context;
+
+export { createAgentConfigContext, createProjectContext, extractWorkspaceHashFromContext, isAgentConfigCtx, isDesignProjectProjectCtx };

package/dist/utils/index.js

@@ -0,0 +1,53 @@
+// src/utils/is-project-ctx.ts
+function isDesignProjectProjectCtx(value) {
+  return typeof value === "object" && value !== null && "projectId" in value && typeof value.projectId === "string" && value.projectId.length > 0;
+}
+
+// src/utils/create-project-context.ts
+function createProjectContext(ctx) {
+  return {
+    description: "project" /* Project */,
+    value: JSON.stringify(ctx)
+  };
+}
+
+// src/utils/extract-workspace-hash-from-context.ts
+function extractWorkspaceHashFromContext(context) {
+  if (!context || !Array.isArray(context)) {
+    return void 0;
+  }
+  for (const ctx of context) {
+    if (!ctx || typeof ctx !== "object") {
+      continue;
+    }
+    const namespace = ctx.description;
+    if (namespace === "project" /* Project */ && ctx.value) {
+      try {
+        const parsed = typeof ctx.value === "string" ? JSON.parse(ctx.value) : ctx.value;
+        if (isDesignProjectProjectCtx(parsed)) {
+          return parsed.workspaceHash;
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+  return void 0;
+}
+
+// src/utils/is-agent-config-ctx.ts
+function isAgentConfigCtx(value) {
+  return typeof value === "object" && value !== null && "modelType" in value && typeof value.modelType === "number";
+}
+
+// src/utils/create-agent-config-context.ts
+function createAgentConfigContext(ctx) {
+  return {
+    description: "agent-config" /* Config */,
+    value: JSON.stringify(ctx)
+  };
+}
+
+export { createAgentConfigContext, createProjectContext, extractWorkspaceHashFromContext, isAgentConfigCtx, isDesignProjectProjectCtx };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/is-project-ctx.ts","../../src/utils/create-project-context.ts","../../src/utils/extract-workspace-hash-from-context.ts","../../src/utils/is-agent-config-ctx.ts","../../src/utils/create-agent-config-context.ts"],"names":[],"mappings":";AAKO,SAAS,0BAA0B,KAAA,EAAkD;AACxF,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA,IACvD,KAAA,CAAkC,UAAU,MAAA,GAAS,CAAA;AAE1D;;;ACDK,SAAS,qBAAqB,GAAA,EAAuC;AAE1E,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,SAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF;;;ACJO,SAAS,gCACd,OAAA,EACoB;AACpB,EAAA,IAAI,CAAC,OAAA,IAAW,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AACvC,IAAA,OAAO,MAAA;AAAA,EACT;AAGA,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,IAAI,CAAC,GAAA,IAAO,OAAO,GAAA,KAAQ,QAAA,EAAU;AACnC,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,YAAY,GAAA,CAAI,WAAA;AACtB,IAAA,IAAI,SAAA,KAAA,SAAA,kBAAmD,IAAI,KAAA,EAAO;AAChE,MAAA,IAAI;AAEF,QAAA,MAAM,MAAA,GAAS,OAAO,GAAA,CAAI,KAAA,KAAU,QAAA,GAAW,KAAK,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,GAAI,GAAA,CAAI,KAAA;AAG3E,QAAA,IAAI,yBAAA,CAA0B,MAAM,CAAA,EAAG;AACrC,UAAA,OAAO,MAAA,CAAO,aAAA;AAAA,QAChB;AAAA,MACF,CAAA,CAAA,MAAQ;AAEN,QAAA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;ACzCO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OACE,OAAO,UAAU,QAAA,IACjB,KAAA,KAAU,QACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAkC,SAAA,KAAc,QAAA;AAE5D;;;ACAO,SAAS,yBAAyB,GAAA,EAA8B;AACrE,EAAA,OAAO;AAAA,IACL,WAAA,EAAA,cAAA;AAAA,IACA,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,GAAG;AAAA,GAC3B;AACF","file":"index.js","sourcesContent":["/**\n * Type guard to check if an object matches DesignProjectProjectCtx\n */\nimport { type DesignProjectProjectCtx } from '../protocol';\n\nexport function isDesignProjectProjectCtx(value: unknown): value is DesignProjectProjectCtx {\n    return (\n      typeof value === 'object' &&\n      value !== null &&\n      'projectId' in value &&\n      typeof (value as Record<string, unknown>).projectId === 'string' &&\n      (value as DesignProjectProjectCtx).projectId.length > 0\n    );\n  }\n  ","/**\n * Create project context for AG-UI RunAgentInput\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create a project context item for AG-UI RunAgentInput\n *\n * @param projectId - The project ID\n * @returns Context item with namespace 'project' and projectId in value\n */\nexport function createProjectContext(ctx: DesignProjectProjectCtx): Context {\n  // const projectCtx: DesignProjectProjectCtx = { projectId, workspaceHash };\n  return {\n    description: DesignProjectCtxNamespace.Project,\n    value: JSON.stringify(ctx),\n  };\n}\n","/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n */\nimport { type DesignProjectProjectCtx, DesignProjectCtxNamespace } from '../protocol';\nimport { isDesignProjectProjectCtx } from './is-project-ctx';\n\n/**\n * Extract workspaceHash from context array\n * Looks for context with namespace 'project' and extracts workspaceHash from value\n *\n * @param context - Context array from RunAgentInput\n * @returns workspaceHash if found, undefined otherwise\n */\nexport function extractWorkspaceHashFromContext(\n  context: Array<{ description?: string; value?: string }> | undefined\n): string | undefined {\n  if (!context || !Array.isArray(context)) {\n    return undefined;\n  }\n\n  // Look for context with namespace 'project'\n  for (const ctx of context) {\n    if (!ctx || typeof ctx !== 'object') {\n      continue;\n    }\n\n    // Check if this is a project context (namespace = 'project')\n    const namespace = ctx.description;\n    if (namespace === DesignProjectCtxNamespace.Project && ctx.value) {\n      try {\n        // Parse value as JSON (AG-UI Context.value is a string)\n        const parsed = typeof ctx.value === 'string' ? JSON.parse(ctx.value) : ctx.value;\n\n        // Use type guard to validate and extract workspaceHash with proper typing\n        if (isDesignProjectProjectCtx(parsed)) {\n          return parsed.workspaceHash;\n        }\n      } catch {\n        // Invalid JSON, skip this context\n        continue;\n      }\n    }\n  }\n\n  return undefined;\n}","/**\n * Type guard to check if an object matches AgentConfigCtx\n */\nimport { type AgentConfigCtx } from '../protocol';\n\nexport function isAgentConfigCtx(value: unknown): value is AgentConfigCtx {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'modelType' in value &&\n    typeof (value as Record<string, unknown>).modelType === 'number'\n  );\n}\n","/**\n * Create agent config context for AG-UI RunAgentInput\n */\nimport { type AgentConfigCtx, AgentConfigCtxNamespace } from '../protocol';\nimport type { Context } from '@ag-ui/core';\n\n/**\n * Create an agent config context item for AG-UI RunAgentInput\n *\n * @param ctx - The agent config context containing modelType\n * @returns Context item with namespace 'agent-config' and modelType in value\n */\nexport function createAgentConfigContext(ctx: AgentConfigCtx): Context {\n  return {\n    description: AgentConfigCtxNamespace.Config,\n    value: JSON.stringify(ctx),\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zk-tech/ag-ui-core",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.10",
   "description": "Extends from AG-UI core with more strict types",
   "license": "MIT",
   "author": "ZK Tech",
@@ -25,6 +25,11 @@
       "types": "./dist/protocol/index.d.ts",
       "import": "./dist/protocol/index.js",
       "require": "./dist/protocol/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs"
     }
   },
   "scripts": {
@@ -34,8 +39,11 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "pnpm run build"
   },
-  "devDependencies": {
+  "dependencies": {
     "@ag-ui/core": "^0.0.42",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },