@dam-agents/cli 0.2.10-rc1 → 0.2.11

package/dist/bin.js

@@ -26836,6 +26836,18 @@ var skillPublishInputSchema = external_exports.object({
   title: external_exports.string().optional(),
   body: external_exports.string().optional()
 });
+var skillCreateLocalInputSchema = external_exports.object({
+  agentId: external_exports.string().min(1),
+  skills: external_exports.array(
+    external_exports.object({
+      name: external_exports.string().min(1).max(128),
+      content: external_exports.string().max(2 * 1024 * 1024)
+    })
+  ).min(1).max(50)
+}).refine(
+  (v2) => v2.skills.reduce((n, s) => n + s.content.length, 0) <= 5 * 1024 * 1024,
+  "batch exceeds 5 MB"
+);
 
 // ../api-server-api/src/modules/templates/schemas.ts
 var templateGetInputSchema = external_exports.object({
@@ -26924,7 +26936,11 @@ var spawnInvocationRequestSchema = external_exports.object({
   // OOM-kills at the template's small default memory, so let the driver raise
   // it. Same grammar and floors as the agent size knob.
   memory: external_exports.string().regex(/^\d+(Mi|Gi)$/, "memory must look like '512Mi' or '4Gi'").optional(),
-  cpu: external_exports.string().regex(/^\d+(\.\d+)?m?$/, "cpu must look like '2', '0.5' or '500m'").optional()
+  cpu: external_exports.string().regex(/^\d+(\.\d+)?m?$/, "cpu must look like '2', '0.5' or '500m'").optional(),
+  // Experiments v2 span attach: "<experimentId>/<spanId>" stamped by the
+  // experiment SDK when the spawn happens inside a span, so the Trace Feed
+  // shows this invocation under its stage. Opaque to invocations.
+  experimentSpanId: external_exports.string().min(1).max(300).optional()
 }).refine((d2) => d2.image !== void 0 || d2.templateId !== void 0, {
   message: "either image or templateId is required"
 });
@@ -26997,6 +27013,16 @@ var skillPublishInputSchema2 = external_exports.object({
 var skillReadLocalInputSchema = external_exports.object({
   name: external_exports.string().min(1)
 });
+var skillWriteLocalInputSchema = external_exports.object({
+  skills: external_exports.array(
+    external_exports.object({
+      /** Confirmed display name — becomes frontmatter `name:`; the dir is its slug. */
+      name: external_exports.string().min(1).max(128),
+      /** Raw Markdown file content; lands as SKILL.md. */
+      content: external_exports.string()
+    })
+  ).min(1).max(50)
+});
 
 // ../agent-runtime-api/src/modules/ssh/schemas.ts
 var sshAuthorizeKeyInputSchema = external_exports.object({
@@ -27023,7 +27049,8 @@ var eventKind = external_exports.enum([
   "trigger",
   "schedule-reset",
   "workspace-seed",
-  "experiment-trigger",
+  "workspace-command",
+  "experiment-execute",
   "harness-config"
 ]);
 var mergeMode = external_exports.enum([
@@ -27128,16 +27155,26 @@ var workspaceSeedEvent = external_exports.object({
   expiresAt: external_exports.string().datetime({ offset: true }),
   payload: workspaceSeedEventPayload
 });
-var experimentTriggerEventPayload = external_exports.object({
+var workspaceCommandEventPayload = external_exports.object({
+  command: external_exports.string().min(1)
+});
+var workspaceCommandEvent = external_exports.object({
+  id: external_exports.string().min(1),
+  kind: external_exports.literal("workspace-command"),
+  version: external_exports.number().int().nonnegative(),
+  expiresAt: external_exports.string().datetime({ offset: true }),
+  payload: workspaceCommandEventPayload
+});
+var experimentExecuteEventPayload = external_exports.object({
   experimentId: external_exports.string().min(1),
   task: external_exports.string().min(1)
 });
-var experimentTriggerEvent = external_exports.object({
+var experimentExecuteEvent = external_exports.object({
   id: external_exports.string().min(1),
-  kind: external_exports.literal("experiment-trigger"),
+  kind: external_exports.literal("experiment-execute"),
   version: external_exports.number().int().nonnegative(),
   expiresAt: external_exports.string().datetime({ offset: true }),
-  payload: experimentTriggerEventPayload
+  payload: experimentExecuteEventPayload
 });
 var harnessConfigEventPayload = external_exports.object({
   model: external_exports.string().min(1).optional(),
@@ -27156,7 +27193,8 @@ var event = external_exports.discriminatedUnion("kind", [
   triggerEvent,
   scheduleResetEvent,
   workspaceSeedEvent,
-  experimentTriggerEvent,
+  workspaceCommandEvent,
+  experimentExecuteEvent,
   harnessConfigEvent
 ]);
 var harnessConfigChoice = external_exports.object({
@@ -27308,6 +27346,7 @@ var agentSizeSchema = external_exports.object({
 var agentUpgradeInputSchema = idSchema.extend({
   expectedToImage: external_exports.string().min(1).optional()
 });
+var agentKindSchema = external_exports.enum(["knowledge-base", "experiment"]);
 var agentCreateInputSchema = external_exports.object({
   name: external_exports.string().min(1).refine((n) => !n.startsWith("agent-"), {
     message: "agent name cannot start with 'agent-' (reserved for IDs)"
@@ -27350,6 +27389,12 @@ var agentCreateInputSchema = external_exports.object({
   // hibernated before the Sweep deletes it. Default zero — deleted as soon
   // as it hibernates. Ignored unless `sweepable`.
   lifetimeMs: external_exports.number().int().min(0).optional()
+  // Agent Kind is deliberately NOT part of this schema: it is a
+  // service-level field (see AgentCreateInput) set only by an owning module's
+  // create path (knowledge-bases, experiments). A `kind` passed to the public
+  // agents.create is stripped, so a caller cannot mint a marked agent that
+  // skipped that module's setup — a KB or experiment sandbox whose Install
+  // Command never ran.
 }).refine((d2) => d2.templateId !== void 0 || d2.image !== void 0, {
   message: "Either templateId or image is required"
 });
@@ -27483,18 +27528,135 @@ var scheduleStatusSchema = external_exports.object({
 });
 
 // ../api-server-api/src/modules/experiments/schemas.ts
-var armVariationSchema = external_exports.string();
+var SCRIPT_CONTENT_MAX_BYTES = 256 * 1024;
+var DASHBOARD_CONTENT_MAX_BYTES = 512 * 1024;
+var CUSTOM_DATA_MAX_BYTES = 128 * 1024;
+var stageIdSchema = external_exports.string().trim().min(1).max(100);
+var spanIdSchema = external_exports.string().min(1).max(200);
+var isoTimestampSchema = external_exports.string().datetime({ offset: true });
+var skeletonSchema = external_exports.object({
+  stages: external_exports.array(
+    external_exports.object({
+      id: stageIdSchema,
+      /** Stage ids this stage runs after (edges of the graph). */
+      after: external_exports.array(stageIdSchema).max(20).default([])
+    })
+  ).max(50).default([]),
+  loops: external_exports.array(
+    external_exports.object({
+      id: stageIdSchema,
+      /** Member stages, iterated together. */
+      stages: external_exports.array(stageIdSchema).min(1).max(50)
+    })
+  ).max(10).default([])
+});
+var planRegisterRequestSchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(200),
+  skeleton: skeletonSchema,
+  script: external_exports.object({
+    /** Pod-local path the harness will execute (`python <path>`). */
+    path: external_exports.string().min(1).max(1024),
+    sha256: external_exports.string().regex(/^[a-f0-9]{64}$/),
+    content: external_exports.string().max(SCRIPT_CONTENT_MAX_BYTES)
+  }),
+  /** Bespoke dashboard HTML captured like the script (the SDK's
+   *  dashboard_path): the platform creates or re-versions the draft's
+   *  dashboard artifact from it. Omitted = keep the existing dashboard, or
+   *  attach the stock one on first registration. */
+  dashboard: external_exports.object({ content: external_exports.string().max(DASHBOARD_CONTENT_MAX_BYTES) }).optional()
+});
+var planRegisterResponseSchema = external_exports.object({
+  experimentId: external_exports.string()
+});
+var runStartEventSchema = external_exports.object({
+  type: external_exports.literal("run-start"),
+  scriptSha256: external_exports.string().regex(/^[a-f0-9]{64}$/),
+  scriptContent: external_exports.string().max(SCRIPT_CONTENT_MAX_BYTES).optional()
+});
+var stageDeclareEventSchema = external_exports.object({
+  type: external_exports.literal("stage-declare"),
+  stage: stageIdSchema
+});
+var spanStartEventSchema = external_exports.object({
+  type: external_exports.literal("span-start"),
+  spanId: spanIdSchema,
+  stage: stageIdSchema,
+  iteration: external_exports.number().int().nonnegative().optional(),
+  parentSpanId: spanIdSchema.optional(),
+  ts: isoTimestampSchema
+});
+var spanEndEventSchema = external_exports.object({
+  type: external_exports.literal("span-end"),
+  spanId: spanIdSchema,
+  status: external_exports.enum(["ok", "error"]),
+  /** Opaque by covenant: captured and charted, never normalized or ranked. */
+  score: external_exports.number().finite().optional(),
+  /** Artifact Library ids this span produced (candidates, reports). */
+  artifactIds: external_exports.array(external_exports.string().min(1)).max(20).optional(),
+  attrs: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  ts: isoTimestampSchema
+});
+var customDataEventSchema = external_exports.object({
+  type: external_exports.literal("custom-data"),
+  data: external_exports.record(external_exports.string(), external_exports.unknown()),
+  /** false replaces the blob instead of shallow-merging into it. */
+  merge: external_exports.boolean().optional()
+});
+var heartbeatEventSchema = external_exports.object({
+  type: external_exports.literal("heartbeat")
+});
+var traceEventSchema = external_exports.discriminatedUnion("type", [
+  runStartEventSchema,
+  stageDeclareEventSchema,
+  spanStartEventSchema,
+  spanEndEventSchema,
+  customDataEventSchema,
+  heartbeatEventSchema
+]);
+var appendEventsRequestSchema = external_exports.object({
+  events: external_exports.array(traceEventSchema).min(1).max(500)
+});
+var appendEventsResponseSchema = external_exports.object({
+  accepted: external_exports.number().int().nonnegative()
+});
+var finishRequestSchema = external_exports.object({
+  status: external_exports.enum(["completed", "failed"]),
+  error: external_exports.string().max(2e3).optional()
+});
 var experimentIdInputSchema = external_exports.object({
   id: external_exports.string().min(1)
 });
-var experimentCreateInputSchema = external_exports.object({
-  name: external_exports.string().trim().min(1, "name is required").max(200),
-  prompt: external_exports.string().trim().min(1, "prompt is required")
+var experimentSandboxCreateInputSchema = external_exports.object({
+  name: external_exports.string().min(1).refine((n) => !n.startsWith("agent-"), {
+    message: "agent name cannot start with 'agent-' (reserved for IDs)"
+  }),
+  templateId: external_exports.string().optional(),
+  image: external_exports.string().optional(),
+  description: external_exports.string().optional(),
+  connectionIds: external_exports.array(external_exports.string()).optional(),
+  egressPreset: egressPresetSchema.optional(),
+  size: agentSizeSchema.optional()
+}).refine((d2) => d2.templateId !== void 0 || d2.image !== void 0, {
+  message: "Either templateId or image is required"
 });
-var experimentAddArmInputSchema = external_exports.object({
-  experimentId: external_exports.string().min(1),
-  agentId: external_exports.string().min(1),
-  armVariation: armVariationSchema.default("")
+
+// ../api-server-api/src/modules/knowledge-bases/schemas.ts
+var knowledgeBaseTemplateIdSchema = external_exports.enum(["llm-wiki", "plain-wiki"]);
+var knowledgeBaseCreateInputSchema = external_exports.object({
+  name: external_exports.string().min(1).refine((n) => !n.startsWith("agent-"), {
+    message: "agent name cannot start with 'agent-' (reserved for IDs)"
+  }),
+  templateId: external_exports.string().optional(),
+  image: external_exports.string().optional(),
+  description: external_exports.string().optional(),
+  connectionIds: external_exports.array(external_exports.string()).optional(),
+  egressPreset: egressPresetSchema.optional(),
+  size: agentSizeSchema.optional(),
+  // Which installation procedure to bootstrap the agent with. Defaults to
+  // the sole current template so older callers keep working.
+  kbTemplateId: knowledgeBaseTemplateIdSchema.default("llm-wiki")
+}).refine((d2) => d2.templateId !== void 0 || d2.image !== void 0, {
+  message: "Either templateId or image is required"
 });
 
 // ../api-server-api/src/modules/artifact-library/schemas.ts
@@ -27568,7 +27730,7 @@ var folderUpdateInputSchema = external_exports.object({
 var folderIdInputSchema = external_exports.object({ id: external_exports.string().min(1) });
 
 // ../api-server-api/src/modules/features/schemas.ts
-var featureIdSchema = external_exports.enum(["advanced-connections", "experiments"]);
+var featureIdSchema = external_exports.enum(["advanced-connections"]);
 var featureSetFlagInputSchema = external_exports.object({
   feature: featureIdSchema,
   enabled: external_exports.boolean()
@@ -30998,6 +31160,7 @@ var clientCredentialsCreateInput = external_exports.object({
 var githubAppCreateInput = external_exports.object({
   ...commonFields,
   authKind: external_exports.literal("github-app"),
+  host: external_exports.string().min(1).optional(),
   appId: external_exports.string().min(1),
   installationId: external_exports.string().min(1),
   privateKey: external_exports.string().min(1)
@@ -31029,7 +31192,8 @@ var SessionType = {
   ChannelSlack: "channel_slack",
   ChannelTelegram: "channel_telegram",
   ScheduleCron: "schedule_cron",
-  ExperimentTrial: "experiment_trial"
+  /** The turn that launches an experiment script (Execute on a draft). */
+  ExperimentExecute: "experiment_execute"
 };
 var SessionMode = /* @__PURE__ */ ((SessionMode2) => {
   SessionMode2["Chat"] = "chat";
@@ -31287,7 +31451,8 @@ var slackOutboundRecordSchema = external_exports.discriminatedUnion("kind", [
     kind: external_exports.literal("message"),
     channel: external_exports.string(),
     text: external_exports.string(),
-    threadTs: external_exports.string().optional()
+    threadTs: external_exports.string().optional(),
+    replyBroadcast: external_exports.boolean().optional()
   }).strict(),
   external_exports.object({
     kind: external_exports.literal("ephemeral"),
@@ -40323,7 +40488,7 @@ function createProcessEnvReader() {
 
 // src/modules/cli/infrastructure/package-version.ts
 function readPackageVersion() {
-  return true ? "0.2.10-rc1" : DEV_VERSION;
+  return true ? "0.2.11" : DEV_VERSION;
 }
 
 // src/modules/cli/infrastructure/version-probe.ts
@@ -40588,7 +40753,7 @@ function buildConnectCommand(deps) {
     String(DEFAULT_TIMEOUT_SECONDS3)
   ).addHelpText(
     "after",
-    '\nExamples:\n  dam connection connect github\n  dam connection connect github --client-id Iv1.\u2026 --client-secret \u2026  # use your own OAuth app\n  dam connection connect github --no-browser\n  dam connection connect my-api --header-name X-API-Key --value sk-\u2026\n  dam connection connect custom-client-credentials --host api.example.com \\\n      --issuer-url https://auth.example.com/realms/main --client-id \u2026 --client-secret \u2026\n  dam connection connect github-app --app-id 123456 --installation-id 987654 \\\n      --private-key "$(cat app.pem)"\n  dam connection connect bob --value sk-\u2026 --config model=premium-shell --config chatMode=code\n  dam connection connect https://mcp.example.com\n  dam connection connect https://mcp.example.com --auth none\n'
+    '\nExamples:\n  dam connection connect github\n  dam connection connect github --client-id Iv1.\u2026 --client-secret \u2026  # use your own OAuth app\n  dam connection connect github --no-browser\n  dam connection connect my-api --header-name X-API-Key --value sk-\u2026\n  dam connection connect custom-client-credentials --host api.example.com \\\n      --issuer-url https://auth.example.com/realms/main --client-id \u2026 --client-secret \u2026\n  dam connection connect github-app --app-id 123456 --installation-id 987654 \\\n      --private-key "$(cat app.pem)"\n  dam connection connect github-enterprise-app --host ghe.acme.com \\\n      --app-id 123456 --installation-id 987654 --private-key "$(cat app.pem)"\n  dam connection connect bob --value sk-\u2026 --config model=premium-shell --config chatMode=code\n  dam connection connect https://mcp.example.com\n  dam connection connect https://mcp.example.com --auth none\n'
   ).action(async (providerOrUrl, opts) => {
     const json2 = opts.json ?? false;
     const timeoutSeconds = parseTimeout2(opts.timeout);
@@ -40865,6 +41030,7 @@ function buildPayload(template, name, values) {
       return {
         ...common2,
         authKind: "github-app",
+        ...v2("host") ? { host: v2("host") } : {},
         appId,
         installationId,
         privateKey

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dam-agents/cli",
   "author": "IBM Corp.",
-  "version": "0.2.10-rc1",
+  "version": "0.2.11",
   "type": "module",
   "license": "Apache-2.0",
   "homepage": "https://github.com/dam-agents/dam/tree/main/packages/cli#readme",
@@ -43,8 +43,8 @@
     "vitest": "^4.1.3",
     "ws": "^8.20.0",
     "zod": "^4.4.3",
+    "agent-runtime-api": "0.0.1",
     "dev-config": "0.0.1",
-    "api-server-api": "0.0.1",
-    "agent-runtime-api": "0.0.1"
+    "api-server-api": "0.0.1"
   }
 }