@xopcai/xopc 0.0.88 → 0.0.90

package/dist/src/cron/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","names":[],"sources":["../../../src/cron/validation.ts"],"sourcesContent":["// Cron input validation using Zod\nimport { z } from 'zod';\nimport nodeCron from 'node-cron';\n\n// Custom cron validation\nconst cronExpression = z.string().superRefine((val, ctx) => {\n  if (!nodeCron.validate(val)) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message: `Invalid cron expression: ${val}`,\n    });\n  }\n});\n\n// Valid timezones (subset of IANA timezones)\nconst validTimezones = [\n  'UTC',\n  'America/New_York',\n  'America/Chicago',\n  'America/Denver',\n  'America/Los_Angeles',\n  'America/Toronto',\n  'Europe/London',\n  'Europe/Paris',\n  'Europe/Berlin',\n  'Europe/Moscow',\n  'Asia/Tokyo',\n  'Asia/Shanghai',\n  'Asia/Hong_Kong',\n  'Asia/Singapore',\n  'Asia/Seoul',\n  'Asia/Dubai',\n  'Asia/Mumbai',\n  'Australia/Sydney',\n  'Pacific/Auckland',\n];\n\nconst CronDeliveryMode = z.enum(['none', 'announce', 'direct']);\n\n/** Treat `''` / `null` / whitespace-only as absent so optional fields do not fail `.min(1)` */\nfunction optionalTrimmedString(max: number, min = 1) {\n  return z.preprocess((v) => {\n    if (v === null || v === undefined) return undefined;\n    if (typeof v !== 'string') return v;\n    const t = v.trim();\n    return t.length === 0 ? undefined : t;\n  }, z.string().min(min).max(max).optional());\n}\n\n/** Optional agent id on create; empty string → undefined. */\nconst optionalJobAgentId = optionalTrimmedString(64, 1);\n\n/** Optional absolute workspace path on create; empty string → undefined. */\nconst optionalJobWorkingDirectory = optionalTrimmedString(4096, 1);\n\n/**\n * PATCH: set string, or `null` / empty to clear `workingDirectory` on the job.\n */\nconst patchJobWorkingDirectory = z.preprocess((v) => {\n  if (v === null) return null;\n  if (v === undefined) return undefined;\n  if (typeof v !== 'string') return v;\n  const t = v.trim();\n  return t.length === 0 ? null : t;\n}, z.union([z.string().min(1).max(4096), z.null()]).optional());\n\n/**\n * PATCH: set string, or `null` / empty to clear `agentId` on the job.\n */\nconst patchJobAgentId = z.preprocess((v) => {\n  if (v === null) return null;\n  if (v === undefined) return undefined;\n  if (typeof v !== 'string') return v;\n  const t = v.trim();\n  return t.length === 0 ? null : t;\n}, z.union([z.string().min(1).max(64), z.null()]).optional());\n\n// CronPayload validation\nconst CronSystemEventPayloadSchema = z.object({\n  kind: z.literal('systemEvent'),\n  text: z.string().min(1).max(50000),\n});\n\nconst CronAgentTurnPayloadSchema = z.object({\n  kind: z.literal('agentTurn'),\n  message: z.string().min(1).max(50000),\n  model: optionalTrimmedString(100, 1),\n  timeoutSeconds: z.number().int().min(10).max(3600).optional(),\n});\n\nconst CronPayloadSchema = z.union([\n  CronSystemEventPayloadSchema,\n  CronAgentTurnPayloadSchema,\n]);\n\n// CronDelivery validation — channel must match gateway UI / message bus ids (telegram, weixin, cli, local, …)\nconst CronDeliverySchema = z.object({\n  mode: CronDeliveryMode.default('none'),\n  channel: optionalTrimmedString(32, 1),\n  to: z.preprocess(\n    (v) => (v === '' || v === null || v === undefined ? undefined : v),\n    z.string().max(100).optional(),\n  ),\n  bestEffort: z.boolean().optional(),\n});\n\nexport const JobDataSchema = z\n  .object({\n    id: z.string().min(1).max(32),\n    name: z.string().max(100).optional(),\n    schedule: cronExpression,\n    enabled: z.boolean(),\n    timezone: z.string().superRefine((val, ctx) => {\n      if (val && !validTimezones.includes(val)) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Invalid timezone: ${val}. Use IANA timezone names.`,\n        });\n      }\n    }).optional(),\n    maxRetries: z.number().int().min(0).max(10).default(3),\n    timeout: z.number().int().min(1000).max(300000).default(180000),\n    created_at: z.string().datetime(),\n    updated_at: z.string().datetime(),\n    sessionTarget: z.enum(['main', 'isolated']).optional(),\n    agentId: optionalTrimmedString(64, 1),\n    workingDirectory: optionalJobWorkingDirectory,\n    payload: CronPayloadSchema,\n    delivery: CronDeliverySchema.optional(),\n    model: optionalTrimmedString(100, 1),\n    state: z.any().optional(),\n  })\n  .strict();\n\nexport const AddJobRequestSchema = z.object({\n  schedule: cronExpression,\n  name: z.string().max(100).optional(),\n  timezone: z.string().optional(),\n  maxRetries: z.number().int().min(0).max(10).optional(),\n  timeout: z.number().int().min(1000).max(300000).optional(),\n  sessionTarget: z.enum(['main', 'isolated']).optional(),\n  agentId: optionalJobAgentId,\n  workingDirectory: optionalJobWorkingDirectory,\n  payload: CronPayloadSchema,\n  delivery: CronDeliverySchema.optional(),\n  model: optionalTrimmedString(100, 1),\n});\n\nexport const UpdateJobRequestSchema = z.object({\n  name: z.string().max(100).optional(),\n  schedule: cronExpression.optional(),\n  timezone: z.string().optional(),\n  maxRetries: z.number().int().min(0).max(10).optional(),\n  timeout: z.number().int().min(1000).max(300000).optional(),\n  enabled: z.boolean().optional(),\n  sessionTarget: z.enum(['main', 'isolated']).optional(),\n  agentId: patchJobAgentId,\n  workingDirectory: patchJobWorkingDirectory,\n  payload: CronPayloadSchema.optional(),\n  delivery: CronDeliverySchema.optional(),\n  model: optionalTrimmedString(100, 1),\n}).refine(\n  (data) => Object.keys(data).length > 0,\n  { message: 'At least one field must be provided for update' }\n);\n\nexport type ValidatedJobData = z.infer<typeof JobDataSchema>;\nexport type ValidatedAddJobRequest = z.infer<typeof AddJobRequestSchema>;\nexport type ValidatedUpdateJobRequest = z.infer<typeof UpdateJobRequestSchema>;\nexport type ValidatedCronPayload = z.infer<typeof CronPayloadSchema>;\nexport type ValidatedCronDelivery = z.infer<typeof CronDeliverySchema>;\n\n// Re-export common validation helpers\nexport { cronExpression };\n"],"mappings":"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"}
+{"version":3,"file":"validation.js","names":[],"sources":["../../../src/cron/validation.ts"],"sourcesContent":["// Cron input validation using Zod\nimport { z } from 'zod';\nimport nodeCron from 'node-cron';\n\n// Custom cron validation\nconst cronExpression = z.string().superRefine((val, ctx) => {\n  if (!nodeCron.validate(val)) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message: `Invalid cron expression: ${val}`,\n    });\n  }\n});\n\n// Valid timezones (subset of IANA timezones)\nconst validTimezones = [\n  'UTC',\n  'America/New_York',\n  'America/Chicago',\n  'America/Denver',\n  'America/Los_Angeles',\n  'America/Toronto',\n  'Europe/London',\n  'Europe/Paris',\n  'Europe/Berlin',\n  'Europe/Moscow',\n  'Asia/Tokyo',\n  'Asia/Shanghai',\n  'Asia/Hong_Kong',\n  'Asia/Singapore',\n  'Asia/Seoul',\n  'Asia/Dubai',\n  'Asia/Mumbai',\n  'Australia/Sydney',\n  'Pacific/Auckland',\n];\n\nconst CronDeliveryMode = z.enum(['none', 'announce', 'direct']);\n\n/** Treat `''` / `null` / whitespace-only as absent so optional fields do not fail `.min(1)` */\nfunction optionalTrimmedString(max: number, min = 1) {\n  return z.preprocess((v) => {\n    if (v === null || v === undefined) return undefined;\n    if (typeof v !== 'string') return v;\n    const t = v.trim();\n    return t.length === 0 ? undefined : t;\n  }, z.string().min(min).max(max).optional());\n}\n\n/** Optional agent id on create; empty string → undefined. */\nconst optionalJobAgentId = optionalTrimmedString(64, 1);\n\n/** Optional absolute workspace path on create; empty string → undefined. */\nconst optionalJobWorkingDirectory = optionalTrimmedString(4096, 1);\n\n/**\n * PATCH: set string, or `null` / empty to clear `workingDirectory` on the job.\n */\nconst patchJobWorkingDirectory = z.preprocess((v) => {\n  if (v === null) return null;\n  if (v === undefined) return undefined;\n  if (typeof v !== 'string') return v;\n  const t = v.trim();\n  return t.length === 0 ? null : t;\n}, z.union([z.string().min(1).max(4096), z.null()]).optional());\n\n/**\n * PATCH: set string, or `null` / empty to clear `agentId` on the job.\n */\nconst patchJobAgentId = z.preprocess((v) => {\n  if (v === null) return null;\n  if (v === undefined) return undefined;\n  if (typeof v !== 'string') return v;\n  const t = v.trim();\n  return t.length === 0 ? null : t;\n}, z.union([z.string().min(1).max(64), z.null()]).optional());\n\n// CronPayload validation\nconst CronSystemEventPayloadSchema = z.object({\n  kind: z.literal('systemEvent'),\n  text: z.string().min(1).max(50000),\n});\n\nconst CronAgentTurnPayloadSchema = z.object({\n  kind: z.literal('agentTurn'),\n  message: z.string().min(1).max(50000),\n  model: optionalTrimmedString(100, 1),\n  timeoutSeconds: z.number().int().min(10).max(3600).optional(),\n});\n\nconst WorkflowRunInputEnvelopeSchema = z.object({\n  payload: z.unknown(),\n  goal: optionalTrimmedString(5000, 1),\n  variables: z.record(z.string(), z.unknown()).optional(),\n  context: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst CronWorkflowRunPayloadSchema = z.object({\n  kind: z.literal('workflowRun'),\n  definitionId: z.string().min(1).max(200),\n  input: z.unknown().optional(),\n  inputEnvelope: WorkflowRunInputEnvelopeSchema.optional(),\n  goal: optionalTrimmedString(5000, 1),\n  agentId: optionalTrimmedString(64, 1),\n  sessionKey: optionalTrimmedString(300, 1),\n  waitForCompletion: z.boolean().optional(),\n  source: z.object({\n    kind: z.literal('cron').optional(),\n    scheduleId: optionalTrimmedString(200, 1),\n    fireId: optionalTrimmedString(200, 1),\n    scheduledAtMs: z.number().int().nonnegative().optional(),\n  }).optional(),\n});\n\nconst CronPayloadSchema = z.union([\n  CronSystemEventPayloadSchema,\n  CronAgentTurnPayloadSchema,\n  CronWorkflowRunPayloadSchema,\n]);\n\n// CronDelivery validation — channel must match gateway UI / message bus ids (telegram, weixin, cli, local, …)\nconst CronDeliverySchema = z.object({\n  mode: CronDeliveryMode.default('none'),\n  channel: optionalTrimmedString(32, 1),\n  to: z.preprocess(\n    (v) => (v === '' || v === null || v === undefined ? undefined : v),\n    z.string().max(100).optional(),\n  ),\n  bestEffort: z.boolean().optional(),\n});\n\nexport const JobDataSchema = z\n  .object({\n    id: z.string().min(1).max(32),\n    name: z.string().max(100).optional(),\n    schedule: cronExpression,\n    enabled: z.boolean(),\n    timezone: z.string().superRefine((val, ctx) => {\n      if (val && !validTimezones.includes(val)) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Invalid timezone: ${val}. Use IANA timezone names.`,\n        });\n      }\n    }).optional(),\n    maxRetries: z.number().int().min(0).max(10).default(3),\n    timeout: z.number().int().min(1000).max(7_200_000).default(180000),\n    created_at: z.string().datetime(),\n    updated_at: z.string().datetime(),\n    sessionTarget: z.enum(['main', 'isolated']).optional(),\n    agentId: optionalTrimmedString(64, 1),\n    workingDirectory: optionalJobWorkingDirectory,\n    payload: CronPayloadSchema,\n    delivery: CronDeliverySchema.optional(),\n    model: optionalTrimmedString(100, 1),\n    state: z.any().optional(),\n  })\n  .strict();\n\nexport const AddJobRequestSchema = z.object({\n  schedule: cronExpression,\n  name: z.string().max(100).optional(),\n  timezone: z.string().optional(),\n  maxRetries: z.number().int().min(0).max(10).optional(),\n  timeout: z.number().int().min(1000).max(7_200_000).optional(),\n  sessionTarget: z.enum(['main', 'isolated']).optional(),\n  agentId: optionalJobAgentId,\n  workingDirectory: optionalJobWorkingDirectory,\n  payload: CronPayloadSchema,\n  delivery: CronDeliverySchema.optional(),\n  model: optionalTrimmedString(100, 1),\n});\n\nexport const UpdateJobRequestSchema = z.object({\n  name: z.string().max(100).optional(),\n  schedule: cronExpression.optional(),\n  timezone: z.string().optional(),\n  maxRetries: z.number().int().min(0).max(10).optional(),\n  timeout: z.number().int().min(1000).max(7_200_000).optional(),\n  enabled: z.boolean().optional(),\n  sessionTarget: z.enum(['main', 'isolated']).optional(),\n  agentId: patchJobAgentId,\n  workingDirectory: patchJobWorkingDirectory,\n  payload: CronPayloadSchema.optional(),\n  delivery: CronDeliverySchema.optional(),\n  model: optionalTrimmedString(100, 1),\n}).refine(\n  (data) => Object.keys(data).length > 0,\n  { message: 'At least one field must be provided for update' }\n);\n\nexport type ValidatedJobData = z.infer<typeof JobDataSchema>;\nexport type ValidatedAddJobRequest = z.infer<typeof AddJobRequestSchema>;\nexport type ValidatedUpdateJobRequest = z.infer<typeof UpdateJobRequestSchema>;\nexport type ValidatedCronPayload = z.infer<typeof CronPayloadSchema>;\nexport type ValidatedCronDelivery = z.infer<typeof CronDeliverySchema>;\n\n// Re-export common validation helpers\nexport { cronExpression };\n"],"mappings":"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"}

package/dist/src/cron/workflow-run-completion.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowRunView } from '../workflows/domain/index.js';
+/** Default wait budget for cron workflow runs (35 minutes). */
+export declare const DEFAULT_WORKFLOW_CRON_WAIT_MS: number;
+export declare const WORKFLOW_CRON_POLL_MS = 3000;
+export declare function resolveWorkflowCronWaitMs(jobTimeoutMs: number | undefined): number;
+export declare function waitForWorkflowRunView(params: {
+    readView: (runId: string) => Promise<WorkflowRunView | null>;
+    runId: string;
+    signal: AbortSignal;
+    timeoutMs: number;
+    pollIntervalMs?: number;
+}): Promise<{
+    kind: 'terminal';
+    view: WorkflowRunView;
+} | {
+    kind: 'timeout';
+    lastView: WorkflowRunView | null;
+} | {
+    kind: 'aborted';
+}>;
+export declare function buildWorkflowRunCronSummary(view: WorkflowRunView): string;
+export declare function isWorkflowRunCronSuccess(view: WorkflowRunView): boolean;
+export declare function buildWorkflowRunDeliveryText(view: WorkflowRunView): string;

package/dist/src/cron/workflow-run-completion.js

@@ -0,0 +1,72 @@
+import { renderWorkflowText } from "../agent/workflow/snapshot.js";
+import { isTerminalWorkflowRunStatus } from "../workflows/domain/run.js";
+import "../workflows/domain/index.js";
+import { runViewToSnapshot } from "../workflows/service/run-view-to-snapshot.js";
+//#region src/cron/workflow-run-completion.ts
+/** Default wait budget for cron workflow runs (35 minutes). */
+const DEFAULT_WORKFLOW_CRON_WAIT_MS = 2100 * 1e3;
+const WORKFLOW_CRON_POLL_MS = 3e3;
+function resolveWorkflowCronWaitMs(jobTimeoutMs) {
+	return Math.max(jobTimeoutMs && Number.isFinite(jobTimeoutMs) ? jobTimeoutMs : 0, DEFAULT_WORKFLOW_CRON_WAIT_MS);
+}
+async function waitForWorkflowRunView(params) {
+	const pollIntervalMs = params.pollIntervalMs ?? 3e3;
+	const deadline = Date.now() + params.timeoutMs;
+	let lastView = null;
+	while (Date.now() < deadline) {
+		if (params.signal.aborted) return { kind: "aborted" };
+		const view = await params.readView(params.runId);
+		if (view) {
+			lastView = view;
+			if (isTerminalWorkflowRunStatus(view.run.status)) return {
+				kind: "terminal",
+				view
+			};
+		}
+		await sleep(pollIntervalMs, params.signal);
+	}
+	return {
+		kind: "timeout",
+		lastView
+	};
+}
+function buildWorkflowRunCronSummary(view) {
+	const status = view.run.status;
+	const label = view.run.goal.trim() || view.run.definitionId;
+	if (status === "succeeded") return `Workflow ${view.run.definitionId} succeeded: ${label}`;
+	if (status === "failed") {
+		const detail = view.run.error?.message?.trim();
+		return detail ? `Workflow ${view.run.definitionId} failed: ${detail}` : `Workflow ${view.run.definitionId} failed`;
+	}
+	if (status === "timeout") return `Workflow ${view.run.definitionId} timed out`;
+	if (status === "cancelled") return `Workflow ${view.run.definitionId} cancelled`;
+	return `Workflow ${view.run.definitionId} finished (${status})`;
+}
+function isWorkflowRunCronSuccess(view) {
+	return view.run.status === "succeeded";
+}
+function buildWorkflowRunDeliveryText(view) {
+	const body = renderWorkflowText(runViewToSnapshot(view), view.run.status === "succeeded", { showResultPreviews: true });
+	return `${buildWorkflowRunCronSummary(view)}\n\n${body}`;
+}
+function sleep(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal.aborted) {
+			reject(/* @__PURE__ */ new Error("aborted"));
+			return;
+		}
+		const timer = setTimeout(resolve, ms);
+		const onAbort = () => {
+			clearTimeout(timer);
+			reject(/* @__PURE__ */ new Error("aborted"));
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+	}).catch((err) => {
+		if (signal.aborted || err instanceof Error && err.message === "aborted") return;
+		throw err;
+	});
+}
+//#endregion
+export { DEFAULT_WORKFLOW_CRON_WAIT_MS, WORKFLOW_CRON_POLL_MS, buildWorkflowRunCronSummary, buildWorkflowRunDeliveryText, isWorkflowRunCronSuccess, resolveWorkflowCronWaitMs, waitForWorkflowRunView };
+
+//# sourceMappingURL=workflow-run-completion.js.map

package/dist/src/cron/workflow-run-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-completion.js","names":[],"sources":["../../../src/cron/workflow-run-completion.ts"],"sourcesContent":["import { renderWorkflowText } from '../agent/workflow/snapshot.js';\nimport type { WorkflowRunView } from '../workflows/domain/index.js';\nimport { isTerminalWorkflowRunStatus } from '../workflows/domain/index.js';\nimport { runViewToSnapshot } from '../workflows/service/run-view-to-snapshot.js';\n\n/** Default wait budget for cron workflow runs (35 minutes). */\nexport const DEFAULT_WORKFLOW_CRON_WAIT_MS = 35 * 60 * 1000;\nexport const WORKFLOW_CRON_POLL_MS = 3000;\n\nexport function resolveWorkflowCronWaitMs(jobTimeoutMs: number | undefined): number {\n  const configured = jobTimeoutMs && Number.isFinite(jobTimeoutMs) ? jobTimeoutMs : 0;\n  return Math.max(configured, DEFAULT_WORKFLOW_CRON_WAIT_MS);\n}\n\nexport async function waitForWorkflowRunView(params: {\n  readView: (runId: string) => Promise<WorkflowRunView | null>;\n  runId: string;\n  signal: AbortSignal;\n  timeoutMs: number;\n  pollIntervalMs?: number;\n}): Promise<\n  | { kind: 'terminal'; view: WorkflowRunView }\n  | { kind: 'timeout'; lastView: WorkflowRunView | null }\n  | { kind: 'aborted' }\n> {\n  const pollIntervalMs = params.pollIntervalMs ?? WORKFLOW_CRON_POLL_MS;\n  const deadline = Date.now() + params.timeoutMs;\n  let lastView: WorkflowRunView | null = null;\n\n  while (Date.now() < deadline) {\n    if (params.signal.aborted) {\n      return { kind: 'aborted' };\n    }\n\n    const view = await params.readView(params.runId);\n    if (view) {\n      lastView = view;\n      if (isTerminalWorkflowRunStatus(view.run.status)) {\n        return { kind: 'terminal', view };\n      }\n    }\n\n    await sleep(pollIntervalMs, params.signal);\n  }\n\n  return { kind: 'timeout', lastView };\n}\n\nexport function buildWorkflowRunCronSummary(view: WorkflowRunView): string {\n  const status = view.run.status;\n  const label = view.run.goal.trim() || view.run.definitionId;\n  if (status === 'succeeded') {\n    return `Workflow ${view.run.definitionId} succeeded: ${label}`;\n  }\n  if (status === 'failed') {\n    const detail = view.run.error?.message?.trim();\n    return detail\n      ? `Workflow ${view.run.definitionId} failed: ${detail}`\n      : `Workflow ${view.run.definitionId} failed`;\n  }\n  if (status === 'timeout') {\n    return `Workflow ${view.run.definitionId} timed out`;\n  }\n  if (status === 'cancelled') {\n    return `Workflow ${view.run.definitionId} cancelled`;\n  }\n  return `Workflow ${view.run.definitionId} finished (${status})`;\n}\n\nexport function isWorkflowRunCronSuccess(view: WorkflowRunView): boolean {\n  return view.run.status === 'succeeded';\n}\n\nexport function buildWorkflowRunDeliveryText(view: WorkflowRunView): string {\n  const snapshot = runViewToSnapshot(view);\n  const completed = view.run.status === 'succeeded';\n  const body = renderWorkflowText(snapshot, completed, { showResultPreviews: true });\n  const header = buildWorkflowRunCronSummary(view);\n  return `${header}\\n\\n${body}`;\n}\n\nfunction sleep(ms: number, signal: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal.aborted) {\n      reject(new Error('aborted'));\n      return;\n    }\n    const timer = setTimeout(resolve, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new Error('aborted'));\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n  }).catch((err) => {\n    if (signal.aborted || (err instanceof Error && err.message === 'aborted')) {\n      return;\n    }\n    throw err;\n  });\n}\n"],"mappings":";;;;;;AAMA,MAAa,gCAAgC,OAAU;AACvD,MAAa,wBAAwB;AAErC,SAAgB,0BAA0B,cAA0C;AAElF,QAAO,KAAK,IADO,gBAAgB,OAAO,SAAS,aAAa,GAAG,eAAe,GACtD,8BAA8B;;AAG5D,eAAsB,uBAAuB,QAU3C;CACA,MAAM,iBAAiB,OAAO,kBAAA;CAC9B,MAAM,WAAW,KAAK,KAAK,GAAG,OAAO;CACrC,IAAI,WAAmC;AAEvC,QAAO,KAAK,KAAK,GAAG,UAAU;AAC5B,MAAI,OAAO,OAAO,QAChB,QAAO,EAAE,MAAM,WAAW;EAG5B,MAAM,OAAO,MAAM,OAAO,SAAS,OAAO,MAAM;AAChD,MAAI,MAAM;AACR,cAAW;AACX,OAAI,4BAA4B,KAAK,IAAI,OAAO,CAC9C,QAAO;IAAE,MAAM;IAAY;IAAM;;AAIrC,QAAM,MAAM,gBAAgB,OAAO,OAAO;;AAG5C,QAAO;EAAE,MAAM;EAAW;EAAU;;AAGtC,SAAgB,4BAA4B,MAA+B;CACzE,MAAM,SAAS,KAAK,IAAI;CACxB,MAAM,QAAQ,KAAK,IAAI,KAAK,MAAM,IAAI,KAAK,IAAI;AAC/C,KAAI,WAAW,YACb,QAAO,YAAY,KAAK,IAAI,aAAa,cAAc;AAEzD,KAAI,WAAW,UAAU;EACvB,MAAM,SAAS,KAAK,IAAI,OAAO,SAAS,MAAM;AAC9C,SAAO,SACH,YAAY,KAAK,IAAI,aAAa,WAAW,WAC7C,YAAY,KAAK,IAAI,aAAa;;AAExC,KAAI,WAAW,UACb,QAAO,YAAY,KAAK,IAAI,aAAa;AAE3C,KAAI,WAAW,YACb,QAAO,YAAY,KAAK,IAAI,aAAa;AAE3C,QAAO,YAAY,KAAK,IAAI,aAAa,aAAa,OAAO;;AAG/D,SAAgB,yBAAyB,MAAgC;AACvE,QAAO,KAAK,IAAI,WAAW;;AAG7B,SAAgB,6BAA6B,MAA+B;CAG1E,MAAM,OAAO,mBAFI,kBAAkB,KAEK,EADtB,KAAK,IAAI,WAAW,aACe,EAAE,oBAAoB,MAAM,CAAC;AAElF,QAAO,GADQ,4BAA4B,KAC3B,CAAC,MAAM;;AAGzB,SAAS,MAAM,IAAY,QAAoC;AAC7D,QAAO,IAAI,SAAe,SAAS,WAAW;AAC5C,MAAI,OAAO,SAAS;AAClB,0BAAO,IAAI,MAAM,UAAU,CAAC;AAC5B;;EAEF,MAAM,QAAQ,WAAW,SAAS,GAAG;EACrC,MAAM,gBAAgB;AACpB,gBAAa,MAAM;AACnB,0BAAO,IAAI,MAAM,UAAU,CAAC;;AAE9B,SAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;GACzD,CAAC,OAAO,QAAQ;AAChB,MAAI,OAAO,WAAY,eAAe,SAAS,IAAI,YAAY,UAC7D;AAEF,QAAM;GACN"}

package/dist/src/extensions/update.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Post-update extension sync — refresh lockfile-managed npm / store extensions.
+ */
+import type { Config } from '../config/schema.js';
+import type { UpdateChannel } from '../infra/update-channels.js';
+export type ExtensionUpdateLogger = {
+    info?: (message: string) => void;
+    warn?: (message: string) => void;
+    error?: (message: string) => void;
+};
+export type ExtensionUpdateStatus = 'updated' | 'unchanged' | 'skipped' | 'error';
+export type ExtensionUpdateOutcome = {
+    extensionId: string;
+    status: ExtensionUpdateStatus;
+    message: string;
+    currentVersion?: string;
+    nextVersion?: string;
+};
+export type ExtensionChannelSyncSummary = {
+    skippedBundled: string[];
+    warnings: string[];
+};
+export type ExtensionPostUpdateResult = {
+    status: 'ok' | 'error' | 'skipped';
+    outcomes: ExtensionUpdateOutcome[];
+    channelSync?: ExtensionChannelSyncSummary;
+};
+export declare function syncExtensionsForUpdateChannel(params: {
+    channel: UpdateChannel;
+    config?: Config;
+    logger?: ExtensionUpdateLogger;
+}): Promise<{
+    skipIds: Set<string>;
+    summary: ExtensionChannelSyncSummary;
+}>;
+export declare function updateNpmInstalledExtensions(params: {
+    extensionIds?: string[];
+    skipIds?: Set<string>;
+    config?: Config;
+    timeoutMs?: number;
+    logger?: ExtensionUpdateLogger;
+}): Promise<{
+    outcomes: ExtensionUpdateOutcome[];
+    status: 'ok' | 'error' | 'skipped';
+}>;
+export declare function runPostUpdateExtensionSync(params: {
+    channel: UpdateChannel;
+    config?: Config;
+    timeoutMs?: number;
+    logger?: ExtensionUpdateLogger;
+}): Promise<ExtensionPostUpdateResult>;

package/dist/src/extensions/update.js

@@ -0,0 +1,260 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from "../config/paths.js";
+import { init_loader, loadConfig } from "../config/loader.js";
+import { getExtensionLockfileManager } from "./lockfile.js";
+import { installExtensionFromStoreZip, installFromNpm } from "./install.js";
+import { findExtension } from "./marketplace.js";
+import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl } from "../agent/skills/marketplace/adapters/store/store-api-client.js";
+import { existsSync, readFileSync, readdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import semver from "semver";
+//#region src/extensions/update.ts
+/**
+* Post-update extension sync — refresh lockfile-managed npm / store extensions.
+*/
+init_paths();
+init_loader();
+init_logger();
+const log = createLogger("ExtensionUpdate");
+const MANIFEST = "xopc.extension.json";
+function readInstalledExtensionVersion(targetDir, extensionId) {
+	const manifestPath = join(targetDir, extensionId, MANIFEST);
+	if (!existsSync(manifestPath)) return;
+	try {
+		const raw = JSON.parse(readFileSync(manifestPath, "utf-8"));
+		return (typeof raw.version === "string" ? semver.valid(raw.version) : null) ?? void 0;
+	} catch {
+		return;
+	}
+}
+async function resolveNpmPackageForId(extensionId) {
+	return (await findExtension(extensionId))?.npmPackage;
+}
+async function upsertNpmExtensionLock(lock, targetDir, result, spec) {
+	if (!result.extensionId) return;
+	const reg = await findExtension(result.extensionId);
+	const resolved = reg?.npmPackage ?? spec;
+	let ver = reg?.version ?? "0.0.0";
+	try {
+		const raw = readFileSync(join(targetDir, result.extensionId, MANIFEST), "utf-8");
+		const m = JSON.parse(raw);
+		const mv = typeof m.version === "string" ? semver.valid(m.version) : null;
+		if (mv) ver = mv;
+	} catch {}
+	await lock.upsert(result.extensionId, {
+		name: result.extensionId,
+		version: ver,
+		resolved,
+		source: "npm"
+	});
+}
+async function installExtensionFromStoreWithLock(params) {
+	try {
+		const { downloadUrl, version } = await resolveExtensionZipDownloadUrl(params.storeBase, params.packageName, params.version);
+		const result = await installExtensionFromStoreZip(await downloadExtensionStoreZipBuffer(params.storeBase, downloadUrl), params.targetDir);
+		if (!result.ok || !result.extensionId) return {
+			ok: false,
+			error: result.error ?? "install failed"
+		};
+		await params.lock.upsert(result.extensionId, {
+			name: result.extensionId,
+			version,
+			resolved: params.packageName,
+			source: "store"
+		});
+		return {
+			ok: true,
+			extensionId: result.extensionId,
+			version
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			error: err instanceof Error ? err.message : String(err)
+		};
+	}
+}
+function listBundledExtensionIds() {
+	const ids = /* @__PURE__ */ new Set();
+	const bundledDir = resolveBundledExtensionsDir();
+	if (!bundledDir || !existsSync(bundledDir)) return ids;
+	for (const entry of readdirSync(bundledDir, { withFileTypes: true })) if (entry.isDirectory()) ids.add(entry.name);
+	return ids;
+}
+async function syncExtensionsForUpdateChannel(params) {
+	const logger = params.logger ?? {};
+	const summary = {
+		skippedBundled: [],
+		warnings: []
+	};
+	const skipIds = /* @__PURE__ */ new Set();
+	if (params.channel !== "dev") return {
+		skipIds,
+		summary
+	};
+	const data = await getExtensionLockfileManager().load();
+	const bundledIds = listBundledExtensionIds();
+	for (const extensionId of Object.keys(data.extensions)) {
+		if (!bundledIds.has(extensionId)) continue;
+		skipIds.add(extensionId);
+		summary.skippedBundled.push(extensionId);
+		logger.info?.(`Skipping "${extensionId}" on dev channel (bundled copy preferred).`);
+	}
+	return {
+		skipIds,
+		summary
+	};
+}
+async function updateSingleExtension(params) {
+	const { extensionId, entry, targetDir, storeBase, lock, timeoutMs, logger } = params;
+	const currentVersion = readInstalledExtensionVersion(targetDir, extensionId);
+	if (entry.source === "store") {
+		const pkgName = entry.resolved?.trim() || extensionId;
+		if (existsSync(join(targetDir, extensionId))) rmSync(join(targetDir, extensionId), {
+			recursive: true,
+			force: true
+		});
+		const result = await installExtensionFromStoreWithLock({
+			storeBase,
+			packageName: pkgName,
+			targetDir,
+			lock
+		});
+		if (result.ok === false) {
+			logger.error?.(`Failed to update ${extensionId}: ${result.error}`);
+			return {
+				extensionId,
+				status: "error",
+				message: result.error,
+				currentVersion
+			};
+		}
+		const nextVersion = result.version;
+		const status = currentVersion && nextVersion && currentVersion === nextVersion ? "unchanged" : "updated";
+		return {
+			extensionId,
+			status,
+			currentVersion,
+			nextVersion,
+			message: status === "unchanged" ? `${extensionId} is up to date (${currentVersion}).` : `Updated ${extensionId}: ${currentVersion ?? "unknown"} -> ${nextVersion}.`
+		};
+	}
+	if (entry.source !== "npm") return {
+		extensionId,
+		status: "skipped",
+		message: `Skipping "${extensionId}" (source: ${entry.source}).`
+	};
+	const spec = entry.resolved?.trim() || await resolveNpmPackageForId(extensionId);
+	if (!spec) return {
+		extensionId,
+		status: "skipped",
+		message: `Skipping "${extensionId}" (could not resolve npm package).`
+	};
+	if (existsSync(join(targetDir, extensionId))) rmSync(join(targetDir, extensionId), {
+		recursive: true,
+		force: true
+	});
+	const installResult = await installFromNpm(spec, targetDir, timeoutMs);
+	if (!installResult.ok) {
+		const message = installResult.error ?? "npm install failed";
+		logger.error?.(`Failed to update ${extensionId}: ${message}`);
+		return {
+			extensionId,
+			status: "error",
+			message,
+			currentVersion
+		};
+	}
+	await upsertNpmExtensionLock(lock, targetDir, installResult, spec);
+	const nextVersion = (installResult.extensionId ? readInstalledExtensionVersion(targetDir, installResult.extensionId) : void 0) ?? entry.version;
+	const resolvedId = installResult.extensionId ?? extensionId;
+	const status = currentVersion && nextVersion && currentVersion === nextVersion ? "unchanged" : "updated";
+	return {
+		extensionId: resolvedId,
+		status,
+		currentVersion,
+		nextVersion,
+		message: status === "unchanged" ? `${resolvedId} is up to date (${currentVersion}).` : `Updated ${resolvedId}: ${currentVersion ?? "unknown"} -> ${nextVersion}.`
+	};
+}
+async function updateNpmInstalledExtensions(params) {
+	const logger = params.logger ?? {};
+	const config = params.config ?? loadConfig();
+	const targetDir = resolveExtensionsDir();
+	const storeBase = resolveExtensionsStoreBaseUrl(config);
+	const lock = getExtensionLockfileManager();
+	const data = await lock.load();
+	const ids = params.extensionIds?.length ? params.extensionIds : Object.keys(data.extensions);
+	if (ids.length === 0) return {
+		outcomes: [],
+		status: "skipped"
+	};
+	const outcomes = [];
+	let hasError = false;
+	for (const extensionId of ids) {
+		if (params.skipIds?.has(extensionId)) {
+			outcomes.push({
+				extensionId,
+				status: "skipped",
+				message: `Skipping "${extensionId}" (channel sync).`
+			});
+			continue;
+		}
+		const entry = data.extensions[extensionId];
+		if (!entry) {
+			outcomes.push({
+				extensionId,
+				status: "skipped",
+				message: `No lockfile entry for "${extensionId}".`
+			});
+			continue;
+		}
+		const outcome = await updateSingleExtension({
+			extensionId,
+			entry,
+			targetDir,
+			storeBase,
+			lock,
+			timeoutMs: params.timeoutMs,
+			logger
+		});
+		outcomes.push(outcome);
+		if (outcome.status === "error") hasError = true;
+		else if (outcome.status === "updated") log.info({
+			extensionId: outcome.extensionId,
+			nextVersion: outcome.nextVersion
+		}, outcome.message);
+	}
+	return {
+		outcomes,
+		status: hasError ? "error" : "ok"
+	};
+}
+async function runPostUpdateExtensionSync(params) {
+	const logger = params.logger ?? {
+		info: (message) => log.info(message),
+		warn: (message) => log.warn(message),
+		error: (message) => log.error(message)
+	};
+	const channelSyncResult = await syncExtensionsForUpdateChannel({
+		channel: params.channel,
+		config: params.config,
+		logger
+	});
+	const updateResult = await updateNpmInstalledExtensions({
+		skipIds: channelSyncResult.skipIds,
+		config: params.config,
+		timeoutMs: params.timeoutMs,
+		logger
+	});
+	return {
+		status: updateResult.status,
+		outcomes: updateResult.outcomes,
+		channelSync: channelSyncResult.summary
+	};
+}
+//#endregion
+export { runPostUpdateExtensionSync, syncExtensionsForUpdateChannel, updateNpmInstalledExtensions };
+
+//# sourceMappingURL=update.js.map

package/dist/src/extensions/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","names":["marketplace.findExtension"],"sources":["../../../src/extensions/update.ts"],"sourcesContent":["/**\n * Post-update extension sync — refresh lockfile-managed npm / store extensions.\n */\n\nimport { existsSync, readFileSync, readdirSync, rmSync } from 'node:fs';\nimport { join } from 'node:path';\nimport semver from 'semver';\n\nimport {\n  downloadExtensionStoreZipBuffer,\n  resolveExtensionZipDownloadUrl,\n  resolveExtensionsStoreBaseUrl,\n} from '../agent/skills/marketplace/adapters/store/store-api-client.js';\nimport type { Config } from '../config/schema.js';\nimport { resolveBundledExtensionsDir, resolveExtensionsDir } from '../config/paths.js';\nimport { loadConfig } from '../config/loader.js';\nimport type { UpdateChannel } from '../infra/update-channels.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  installExtensionFromStoreZip,\n  installFromNpm,\n  type InstallResult,\n} from './install.js';\nimport {\n  getExtensionLockfileManager,\n  type ExtensionLockEntry,\n} from './lockfile.js';\nimport * as marketplace from './marketplace.js';\n\nconst log = createLogger('ExtensionUpdate');\n\nconst MANIFEST = 'xopc.extension.json';\n\nexport type ExtensionUpdateLogger = {\n  info?: (message: string) => void;\n  warn?: (message: string) => void;\n  error?: (message: string) => void;\n};\n\nexport type ExtensionUpdateStatus = 'updated' | 'unchanged' | 'skipped' | 'error';\n\nexport type ExtensionUpdateOutcome = {\n  extensionId: string;\n  status: ExtensionUpdateStatus;\n  message: string;\n  currentVersion?: string;\n  nextVersion?: string;\n};\n\nexport type ExtensionChannelSyncSummary = {\n  skippedBundled: string[];\n  warnings: string[];\n};\n\nexport type ExtensionPostUpdateResult = {\n  status: 'ok' | 'error' | 'skipped';\n  outcomes: ExtensionUpdateOutcome[];\n  channelSync?: ExtensionChannelSyncSummary;\n};\n\nfunction readInstalledExtensionVersion(targetDir: string, extensionId: string): string | undefined {\n  const manifestPath = join(targetDir, extensionId, MANIFEST);\n  if (!existsSync(manifestPath)) {\n    return undefined;\n  }\n  try {\n    const raw = JSON.parse(readFileSync(manifestPath, 'utf-8')) as { version?: string };\n    const version = typeof raw.version === 'string' ? semver.valid(raw.version) : null;\n    return version ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function resolveNpmPackageForId(extensionId: string): Promise<string | undefined> {\n  const found = await marketplace.findExtension(extensionId);\n  return found?.npmPackage;\n}\n\nasync function upsertNpmExtensionLock(\n  lock: ReturnType<typeof getExtensionLockfileManager>,\n  targetDir: string,\n  result: InstallResult,\n  spec: string,\n): Promise<void> {\n  if (!result.extensionId) return;\n  const reg = await marketplace.findExtension(result.extensionId);\n  const resolved = reg?.npmPackage ?? spec;\n  let ver = reg?.version ?? '0.0.0';\n  try {\n    const raw = readFileSync(join(targetDir, result.extensionId, MANIFEST), 'utf-8');\n    const m = JSON.parse(raw) as { version?: string };\n    const mv = typeof m.version === 'string' ? semver.valid(m.version) : null;\n    if (mv) ver = mv;\n  } catch {\n    // keep registry / fallback version\n  }\n  await lock.upsert(result.extensionId, {\n    name: result.extensionId,\n    version: ver,\n    resolved,\n    source: 'npm',\n  });\n}\n\nasync function installExtensionFromStoreWithLock(params: {\n  storeBase: string;\n  packageName: string;\n  version?: string;\n  targetDir: string;\n  lock: ReturnType<typeof getExtensionLockfileManager>;\n}): Promise<{ ok: true; extensionId: string; version: string } | { ok: false; error: string }> {\n  try {\n    const { downloadUrl, version } = await resolveExtensionZipDownloadUrl(\n      params.storeBase,\n      params.packageName,\n      params.version,\n    );\n    const buf = await downloadExtensionStoreZipBuffer(params.storeBase, downloadUrl);\n    const result = await installExtensionFromStoreZip(buf, params.targetDir);\n    if (!result.ok || !result.extensionId) {\n      return { ok: false, error: result.error ?? 'install failed' };\n    }\n    await params.lock.upsert(result.extensionId, {\n      name: result.extensionId,\n      version,\n      resolved: params.packageName,\n      source: 'store',\n    });\n    return { ok: true, extensionId: result.extensionId, version };\n  } catch (err) {\n    return { ok: false, error: err instanceof Error ? err.message : String(err) };\n  }\n}\n\nfunction listBundledExtensionIds(): Set<string> {\n  const ids = new Set<string>();\n  const bundledDir = resolveBundledExtensionsDir();\n  if (!bundledDir || !existsSync(bundledDir)) {\n    return ids;\n  }\n  for (const entry of readdirSync(bundledDir, { withFileTypes: true })) {\n    if (entry.isDirectory()) {\n      ids.add(entry.name);\n    }\n  }\n  return ids;\n}\n\nexport async function syncExtensionsForUpdateChannel(params: {\n  channel: UpdateChannel;\n  config?: Config;\n  logger?: ExtensionUpdateLogger;\n}): Promise<{ skipIds: Set<string>; summary: ExtensionChannelSyncSummary }> {\n  const logger = params.logger ?? {};\n  const summary: ExtensionChannelSyncSummary = {\n    skippedBundled: [],\n    warnings: [],\n  };\n  const skipIds = new Set<string>();\n\n  if (params.channel !== 'dev') {\n    return { skipIds, summary };\n  }\n\n  const lock = getExtensionLockfileManager();\n  const data = await lock.load();\n  const bundledIds = listBundledExtensionIds();\n\n  for (const extensionId of Object.keys(data.extensions)) {\n    if (!bundledIds.has(extensionId)) {\n      continue;\n    }\n    skipIds.add(extensionId);\n    summary.skippedBundled.push(extensionId);\n    logger.info?.(`Skipping \"${extensionId}\" on dev channel (bundled copy preferred).`);\n  }\n\n  return { skipIds, summary };\n}\n\nasync function updateSingleExtension(params: {\n  extensionId: string;\n  entry: ExtensionLockEntry;\n  targetDir: string;\n  storeBase: string;\n  lock: ReturnType<typeof getExtensionLockfileManager>;\n  timeoutMs?: number;\n  logger?: ExtensionUpdateLogger;\n}): Promise<ExtensionUpdateOutcome> {\n  const { extensionId, entry, targetDir, storeBase, lock, timeoutMs, logger } = params;\n  const currentVersion = readInstalledExtensionVersion(targetDir, extensionId);\n\n  if (entry.source === 'store') {\n    const pkgName = entry.resolved?.trim() || extensionId;\n    if (existsSync(join(targetDir, extensionId))) {\n      rmSync(join(targetDir, extensionId), { recursive: true, force: true });\n    }\n    const result = await installExtensionFromStoreWithLock({\n      storeBase,\n      packageName: pkgName,\n      targetDir,\n      lock,\n    });\n    if (result.ok === false) {\n      logger.error?.(`Failed to update ${extensionId}: ${result.error}`);\n      return {\n        extensionId,\n        status: 'error',\n        message: result.error,\n        currentVersion,\n      };\n    }\n    const nextVersion = result.version;\n    const status =\n      currentVersion && nextVersion && currentVersion === nextVersion ? 'unchanged' : 'updated';\n    return {\n      extensionId,\n      status,\n      currentVersion,\n      nextVersion,\n      message:\n        status === 'unchanged'\n          ? `${extensionId} is up to date (${currentVersion}).`\n          : `Updated ${extensionId}: ${currentVersion ?? 'unknown'} -> ${nextVersion}.`,\n    };\n  }\n\n  if (entry.source !== 'npm') {\n    return {\n      extensionId,\n      status: 'skipped',\n      message: `Skipping \"${extensionId}\" (source: ${entry.source}).`,\n    };\n  }\n\n  const spec = entry.resolved?.trim() || (await resolveNpmPackageForId(extensionId));\n  if (!spec) {\n    return {\n      extensionId,\n      status: 'skipped',\n      message: `Skipping \"${extensionId}\" (could not resolve npm package).`,\n    };\n  }\n\n  if (existsSync(join(targetDir, extensionId))) {\n    rmSync(join(targetDir, extensionId), { recursive: true, force: true });\n  }\n\n  const installResult = await installFromNpm(spec, targetDir, timeoutMs);\n  if (!installResult.ok) {\n    const message = installResult.error ?? 'npm install failed';\n    logger.error?.(`Failed to update ${extensionId}: ${message}`);\n    return {\n      extensionId,\n      status: 'error',\n      message,\n      currentVersion,\n    };\n  }\n\n  await upsertNpmExtensionLock(lock, targetDir, installResult, spec);\n  const nextVersion =\n    (installResult.extensionId\n      ? readInstalledExtensionVersion(targetDir, installResult.extensionId)\n      : undefined) ?? entry.version;\n  const resolvedId = installResult.extensionId ?? extensionId;\n  const status =\n    currentVersion && nextVersion && currentVersion === nextVersion ? 'unchanged' : 'updated';\n  return {\n    extensionId: resolvedId,\n    status,\n    currentVersion,\n    nextVersion,\n    message:\n      status === 'unchanged'\n        ? `${resolvedId} is up to date (${currentVersion}).`\n        : `Updated ${resolvedId}: ${currentVersion ?? 'unknown'} -> ${nextVersion}.`,\n  };\n}\n\nexport async function updateNpmInstalledExtensions(params: {\n  extensionIds?: string[];\n  skipIds?: Set<string>;\n  config?: Config;\n  timeoutMs?: number;\n  logger?: ExtensionUpdateLogger;\n}): Promise<{ outcomes: ExtensionUpdateOutcome[]; status: 'ok' | 'error' | 'skipped' }> {\n  const logger = params.logger ?? {};\n  const config = params.config ?? loadConfig();\n  const targetDir = resolveExtensionsDir();\n  const storeBase = resolveExtensionsStoreBaseUrl(config);\n  const lock = getExtensionLockfileManager();\n  const data = await lock.load();\n\n  const ids = params.extensionIds?.length\n    ? params.extensionIds\n    : Object.keys(data.extensions);\n\n  if (ids.length === 0) {\n    return { outcomes: [], status: 'skipped' };\n  }\n\n  const outcomes: ExtensionUpdateOutcome[] = [];\n  let hasError = false;\n\n  for (const extensionId of ids) {\n    if (params.skipIds?.has(extensionId)) {\n      outcomes.push({\n        extensionId,\n        status: 'skipped',\n        message: `Skipping \"${extensionId}\" (channel sync).`,\n      });\n      continue;\n    }\n\n    const entry = data.extensions[extensionId];\n    if (!entry) {\n      outcomes.push({\n        extensionId,\n        status: 'skipped',\n        message: `No lockfile entry for \"${extensionId}\".`,\n      });\n      continue;\n    }\n\n    const outcome = await updateSingleExtension({\n      extensionId,\n      entry,\n      targetDir,\n      storeBase,\n      lock,\n      timeoutMs: params.timeoutMs,\n      logger,\n    });\n    outcomes.push(outcome);\n    if (outcome.status === 'error') {\n      hasError = true;\n    } else if (outcome.status === 'updated') {\n      log.info(\n        { extensionId: outcome.extensionId, nextVersion: outcome.nextVersion },\n        outcome.message,\n      );\n    }\n  }\n\n  return { outcomes, status: hasError ? 'error' : 'ok' };\n}\n\nexport async function runPostUpdateExtensionSync(params: {\n  channel: UpdateChannel;\n  config?: Config;\n  timeoutMs?: number;\n  logger?: ExtensionUpdateLogger;\n}): Promise<ExtensionPostUpdateResult> {\n  const logger = params.logger ?? {\n    info: (message) => log.info(message),\n    warn: (message) => log.warn(message),\n    error: (message) => log.error(message),\n  };\n\n  const channelSyncResult = await syncExtensionsForUpdateChannel({\n    channel: params.channel,\n    config: params.config,\n    logger,\n  });\n\n  const updateResult = await updateNpmInstalledExtensions({\n    skipIds: channelSyncResult.skipIds,\n    config: params.config,\n    timeoutMs: params.timeoutMs,\n    logger,\n  });\n\n  return {\n    status: updateResult.status,\n    outcomes: updateResult.outcomes,\n    channelSync: channelSyncResult.summary,\n  };\n}\n"],"mappings":"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"}

package/dist/src/gateway/agents-admin.d.ts

@@ -2,16 +2,20 @@
  * Gateway REST helpers for multi-agent management.
  */
 import type { Config } from '../config/schema.js';
+import type { LocalizedText } from '../config/localized-text.js';
 import type { AgentTypedModel } from '../config/schema.js';
 export type GatewayAgentTypedModelsInfo = {
     defaults: AgentTypedModel[];
-    entry?: AgentTypedModel[];
     effective: AgentTypedModel[];
 };
 export type GatewayAgentRow = {
     id: string;
     name?: string;
     description?: string;
+    localized?: {
+        name?: LocalizedText;
+        description?: LocalizedText;
+    };
     /** Value from `IDENTITY.md` **Avatar:** line when present (may be URL, `xopc:…`, etc.). */
     avatar?: string;
     workspace: string;
@@ -41,20 +45,24 @@ export type GatewayAgentsListResponse = {
 };
 /** Extract `**Avatar:**` value from profile IDENTITY.md (same line shape as the gateway console parser). */
 export declare function extractAvatarFromIdentityMarkdown(content: string): string | undefined;
-export declare function listGatewayAgents(cfg: Config): Promise<GatewayAgentsListResponse>;
+export declare function listGatewayAgents(cfg: Config, options?: {
+    locale?: string;
+}): Promise<GatewayAgentsListResponse>;
 export type CreateAgentBody = {
     /** Display name stored on the agent entry. */
-    name: string;
+    name: LocalizedText;
     /** Optional id seed; normalized agent id defaults from `name` when omitted. */
     id?: string;
     workspace: string;
     model?: string;
     agentDir?: string;
-    description?: string;
+    description?: LocalizedText;
     /** Initial `agents.list[].tools.disable` for the new entry. */
     toolsDisable?: string[];
     /** Profile markdown files to write after seeding (e.g. `IDENTITY.md`, `SOUL.md`). */
     profileFiles?: Record<string, string>;
+    /** Clone from an existing agent id — copies config entry fields and profile directory. */
+    cloneFrom?: string;
 };
 export type AgentAdminHttpStatus = 400 | 404 | 409;
 export type AgentAdminResult<T> = {
@@ -80,10 +88,11 @@ export declare function prepareCreateAgentsBatch(cfg: Config, bodies: CreateAgen
 }>;
 export declare function finalizeCreateAgentDirs(cfg: Config, agentId: string, opts?: {
     profileFiles?: Record<string, string>;
+    cloneFrom?: string;
 }): Promise<AgentAdminResult<void>>;
 export type UpdateAgentBody = {
-    name?: string;
-    description?: string | null;
+    name?: LocalizedText;
+    description?: LocalizedText | null;
     workspace?: string;
     model?: string | null;
     agentDir?: string | null;
@@ -92,8 +101,6 @@ export type UpdateAgentBody = {
     skills?: string[] | null;
     /** Replace `agents.list[].tools.disable`; `null` clears entry-level disables. */
     toolsDisable?: string[] | null;
-    /** Replace `agents.list[].models`; `null` removes entry overrides (inherit defaults). */
-    models?: AgentTypedModel[] | null;
 };
 export declare function prepareUpdateAgent(cfg: Config, agentIdRaw: string, body: UpdateAgentBody): AgentAdminResult<{
     nextConfig: Config;