@signaliz/sdk 1.0.14 → 1.0.16

package/dist/cli.js

@@ -1711,6 +1711,12 @@ var CampaignBuilderAgent = class {
     });
     return createCampaignBuilderProofReceipt(plan, result);
   }
+  buildKit(options = {}) {
+    return createCampaignBuilderBuildKit(options);
+  }
+  memoryKit(options = {}) {
+    return createCampaignBuilderMemoryKit(options);
+  }
   async commitPlan(plan, options = {}) {
     const writeMode = options.confirm === true && options.dryRun === false;
     if (writeMode && !options.approvedBy) {
@@ -2375,6 +2381,303 @@ function createCampaignBuilderAgentRequestTemplate(input = {}) {
     }
   });
 }
+function createCampaignBuilderBuildKit(input = {}) {
+  const requestFile = input.requestFile || "campaign-request.json";
+  const cliPackage = input.cliPackage || "@signaliz/cli";
+  const sdkPackage = input.sdkPackage || "@signaliz/sdk";
+  const request = createCampaignBuilderAgentRequestTemplate(input);
+  const strategyTemplate = stringValue(request.strategyTemplate) ?? null;
+  const builtIns = request.builtIns ?? DEFAULT_CAMPAIGN_BUILDER_BUILT_INS;
+  const useLocalLeads = builtIns.includes("local_leads");
+  const customRoutes = [
+    ...request.integrations ?? [],
+    ...routesFromCustomerTools(request.customerTools ?? [])
+  ].filter((route) => route.provider !== "signaliz");
+  const strategyFlag = strategyTemplate ? ` --strategy-template ${shellArg(strategyTemplate)}` : "";
+  const targetFlag = request.targetCount ? ` --target-count ${request.targetCount}` : "";
+  const localLeadsFlag = useLocalLeads ? " --use-local-leads" : "";
+  const cliBase = `npx ${cliPackage}`;
+  const sdkCliBase = `npx ${sdkPackage}`;
+  const brief = request.goal || "Build a strategy-template campaign for the target ICP.";
+  const mcpArgs = campaignBuilderBuildKitMcpArgs(request);
+  return {
+    kit_version: "campaign-builder-kit.v1",
+    source: "signaliz.campaignBuilderAgent.buildKit",
+    request_file: requestFile,
+    request,
+    strategy_template: strategyTemplate,
+    built_in_lanes: builtIns,
+    operating_playbooks: getCampaignBuilderOperatingPlaybooksForRequest(request).map((playbook) => playbook.slug),
+    custom_routes: customRoutes.map((route) => ({
+      provider: String(route.provider),
+      layer: String(route.layer),
+      tool: firstNonEmptyString(route.toolName),
+      mcp_server: firstNonEmptyString(route.mcpServerName),
+      mode: route.mode ?? "if_available",
+      approval_required: route.approvalRequired === true || route.mode === "required"
+    })),
+    approval_boundaries: request.approvalPolicy?.requireApprovalFor ?? DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES,
+    byo_tool_pattern: {
+      cli_flag: "--custom-tool provider:layer:tool[:mcp]",
+      request_fragment: createCampaignBuilderToolRoute({
+        provider: "workspace_mcp",
+        layer: "enrichment",
+        gtmLayers: ["company_enrichment"],
+        toolName: "workspace_account_enrich",
+        mcpServerName: "workspace-mcp",
+        label: "Workspace account enrichment",
+        mode: "required",
+        approvalRequired: true
+      })
+    },
+    cli_commands: [
+      {
+        id: "write_request",
+        label: "Write reusable request JSON",
+        command: `${cliBase} campaign-agent init${strategyFlag}${targetFlag}${localLeadsFlag} --output-file ${shellArg(requestFile)}`,
+        safety: "local file only; no MCP calls, credits, provider writes, sender loads, exports, or sends"
+      },
+      {
+        id: "memory_kit",
+        label: "Inspect memory readiness and seed runner",
+        command: `${sdkCliBase} campaign-agent memory-kit${strategyFlag}${targetFlag}${localLeadsFlag} --request-file ${shellArg(requestFile)} --json`,
+        safety: "read-only memory readiness packet plus local seed dry-run commands"
+      },
+      {
+        id: "proof_shortcut",
+        label: "Run no-spend campaign-builder proof",
+        command: `${cliBase} build ${shellArg(brief)}${strategyFlag}${targetFlag}${localLeadsFlag} --json`,
+        safety: "strategy memory, Kernel plan, approvals, and forced build_campaign dry-run only"
+      },
+      {
+        id: "plan",
+        label: "Inspect the full campaign-agent plan",
+        command: `${sdkCliBase} campaign-agent plan --request-file ${shellArg(requestFile)} --json`,
+        safety: "read-only MCP planning and provider-route dry-runs"
+      },
+      {
+        id: "doctor",
+        label: "Check readiness gates",
+        command: `${sdkCliBase} campaign-agent doctor --request-file ${shellArg(requestFile)} --json`,
+        safety: "read-only readiness checks for Memory, Brain, built-ins, BYO routes, and approvals"
+      },
+      {
+        id: "commit_preview",
+        label: "Preview GTM campaign object commit",
+        command: `${sdkCliBase} campaign-agent commit-plan --request-file ${shellArg(requestFile)} --json`,
+        safety: "dry-run commit; writes only with --confirm-write and --approved-by"
+      },
+      {
+        id: "approved_launch",
+        label: "Launch after explicit approval",
+        command: `${sdkCliBase} campaign-agent build-approved --request-file ${shellArg(requestFile)} --confirm-launch --approve-all --approved-by operator@example.com --spend-limit ${request.signalizDefaults?.maxCredits ?? 0} --json`,
+        safety: "spendful path; requires human approval identity, approval types, and spend limit"
+      }
+    ],
+    mcp_calls: [
+      {
+        id: "request_template",
+        tool: "gtm_campaign_agent_request_template",
+        arguments: mcpArgs,
+        safety: "read-only reusable request generation"
+      },
+      {
+        id: "readiness",
+        tool: "gtm_campaign_agent_readiness",
+        arguments: mcpArgs,
+        safety: "read-only preflight across strategy memory, Kernel plan, lanes, routes, and approvals"
+      },
+      {
+        id: "proof",
+        tool: "gtm_campaign_agent_proof",
+        arguments: { ...mcpArgs, idempotency_key: "campaign-agent-proof-001" },
+        safety: "forces build_campaign dry_run=true and confirm_spend=false"
+      },
+      {
+        id: "plan",
+        tool: "gtm_campaign_agent_plan",
+        arguments: mcpArgs,
+        safety: "read-only one-call campaign-agent runbook"
+      },
+      {
+        id: "commit_preview",
+        tool: "gtm_campaign_build_plan_commit",
+        arguments: {
+          name: request.campaignName,
+          campaign_brief: request.goal,
+          lead_count: request.targetCount,
+          dry_run: true,
+          confirm: false
+        },
+        safety: "dry-run commit preview only"
+      }
+    ],
+    sdk_example: {
+      language: "typescript",
+      code: campaignBuilderBuildKitSdkExample(request, requestFile)
+    },
+    verification: [
+      `${cliBase} campaign-agent proof --request-file ${shellArg(requestFile)} --json`,
+      `${cliBase} campaign-agent doctor --request-file ${shellArg(requestFile)} --json`,
+      "Confirm proof.success is true and dry_run_result.status is dry_run before any approved launch.",
+      "Confirm no campaign_build_id exists in a proof receipt before moving to approved launch."
+    ],
+    privacy: {
+      client_names_allowed: false,
+      notes: [
+        "Use strategy templates, operating playbooks, and anonymized workflow patterns instead of client names.",
+        "Do not include raw leads, private replies, domains, secrets, or customer account labels in public kit output."
+      ]
+    },
+    next_actions: [
+      `Write or review ${requestFile}.`,
+      "Run the proof command before spending credits or activating provider writes.",
+      "Add BYO integrations with --custom-tool provider:layer:tool[:mcp] or the request_fragment shape.",
+      "Use build-approved only after human approval, spend limit, and delivery review policy are set."
+    ]
+  };
+}
+function createCampaignBuilderMemoryKit(input = {}) {
+  const requestFile = input.requestFile || "campaign-request.json";
+  const seedManifestFile = input.seedManifestFile || ".gtm-kernel-import-state/campaign-memory-dry-run.json";
+  const cliPackage = input.cliPackage || "@signaliz/cli";
+  const sdkPackage = input.sdkPackage || "@signaliz/sdk";
+  const request = createCampaignBuilderAgentRequestTemplate(input);
+  const strategyTemplate = stringValue(request.strategyTemplate) ?? null;
+  const strategyFlag = strategyTemplate ? ` --strategy-template ${shellArg(strategyTemplate)}` : "";
+  const targetFlag = request.targetCount ? ` --target-count ${request.targetCount}` : "";
+  const localLeadsFlag = request.builtIns?.includes("local_leads") ? " --use-local-leads" : "";
+  const cliBase = `npx ${cliPackage}`;
+  const sdkCliBase = `npx ${sdkPackage}`;
+  const source = campaignBuilderMemoryKitSource(input.source);
+  const workspaceId = input.workspaceId || "your-workspace-id";
+  const brief = request.goal || "Build a strategy-template campaign for the target ICP.";
+  const statusArgs = compact({
+    strategy_template: strategyTemplate,
+    campaign_brief: brief,
+    target_icp: request.icp,
+    include_sources: true,
+    include_samples: false,
+    days: 90,
+    limit: 25
+  });
+  const searchArgs = compact({
+    query: request.memory?.queries?.[0]?.query || brief,
+    layers: ["lead_generation", "email_finding", "email_verification", "company_enrichment", "copy_enrichment"],
+    limit: 10
+  });
+  return {
+    kit_version: "campaign-memory-kit.v1",
+    source: "signaliz.campaignBuilderAgent.memoryKit",
+    read_only: true,
+    no_spend: true,
+    no_provider_writes: true,
+    client_names_allowed: false,
+    request_file: requestFile,
+    seed_manifest_file: seedManifestFile,
+    request,
+    strategy_template: strategyTemplate,
+    operating_playbooks: getCampaignBuilderOperatingPlaybooksForRequest(request).map((playbook) => playbook.slug),
+    memory_sources: source.memorySources,
+    seed_runner: {
+      local_script: "scripts/gtm-kernel/seed-import-runner.mjs",
+      dry_run_command: [
+        "node scripts/gtm-kernel/seed-import-runner.mjs",
+        `--source ${source.seedSource}`,
+        "--dry-run",
+        `--workspace-id ${shellArg(input.workspaceId || "00000000-0000-4000-8000-000000000000")}`,
+        `--manifest ${shellArg(seedManifestFile)}`,
+        "--reset"
+      ].join(" "),
+      verify_manifest_command: source.verifyScript ? `node ${source.verifyScript} ${shellArg(seedManifestFile)}` : null,
+      write_command: `GTM_KERNEL_WORKSPACE_ID=${shellArg(workspaceId)} node scripts/gtm-kernel/seed-import-runner.mjs --source ${source.seedSource} --write`,
+      write_requires: ["SUPABASE_URL", "SUPABASE_SERVICE_ROLE_KEY", "GTM_KERNEL_WORKSPACE_ID", "explicit operator approval"]
+    },
+    cli_commands: [
+      {
+        id: "memory_status",
+        label: "Check strategy memory readiness",
+        command: `${sdkCliBase} gtm strategy-memory${strategyFlag} --brief ${shellArg(brief)} --json`,
+        safety: "read-only MCP memory readiness; no credits, provider writes, sender loads, exports, or sends"
+      },
+      {
+        id: "memory_search",
+        label: "Search ranked campaign memory",
+        command: `${sdkCliBase} gtm memory search --query ${shellArg(String(searchArgs.query || brief))} --limit 10 --json`,
+        safety: "read-only ranked memory lookup"
+      },
+      {
+        id: "seed_dry_run",
+        label: "Dry-run private memory seed import",
+        command: [
+          "node scripts/gtm-kernel/seed-import-runner.mjs",
+          `--source ${source.seedSource}`,
+          "--dry-run",
+          `--workspace-id ${shellArg(input.workspaceId || "00000000-0000-4000-8000-000000000000")}`,
+          `--manifest ${shellArg(seedManifestFile)}`,
+          "--reset"
+        ].join(" "),
+        safety: "local extraction and manifest only; no database writes"
+      },
+      {
+        id: "write_request",
+        label: "Write reusable campaign request JSON",
+        command: `${cliBase} campaign-agent init${strategyFlag}${targetFlag}${localLeadsFlag} --output-file ${shellArg(requestFile)}`,
+        safety: "local file only; no MCP calls, credits, provider writes, sender loads, exports, or sends"
+      },
+      {
+        id: "proof",
+        label: "Run campaign proof after memory check",
+        command: `${cliBase} campaign-agent proof --request-file ${shellArg(requestFile)} --json`,
+        safety: "read-only planning plus forced build_campaign dry-run with confirm_spend=false"
+      }
+    ],
+    mcp_calls: [
+      {
+        id: "strategy_memory_status",
+        tool: "gtm_campaign_strategy_memory_status",
+        arguments: statusArgs,
+        safety: "read-only strategy/workflow memory readiness with sources and no raw samples"
+      },
+      {
+        id: "memory_search",
+        tool: "gtm_memory_search",
+        arguments: searchArgs,
+        safety: "read-only ranked memory lookup"
+      },
+      {
+        id: "campaign_agent_plan",
+        tool: "gtm_campaign_agent_plan",
+        arguments: campaignBuilderBuildKitMcpArgs(request),
+        safety: "read-only campaign-agent plan using built-in Signaliz lanes, memory, Brain, Nango, and BYO routes"
+      },
+      {
+        id: "campaign_agent_proof",
+        tool: "gtm_campaign_agent_proof",
+        arguments: { ...campaignBuilderBuildKitMcpArgs(request), idempotency_key: "campaign-agent-memory-proof-001" },
+        safety: "forces build_campaign dry_run=true and confirm_spend=false after readiness"
+      }
+    ],
+    sdk_example: {
+      language: "typescript",
+      code: campaignBuilderMemoryKitSdkExample(request, seedManifestFile)
+    },
+    privacy: {
+      client_names_allowed: false,
+      notes: [
+        "Use strategy templates, operating playbooks, memory dimensions, and anonymized campaign patterns instead of client names.",
+        "Do not expose raw leads, private replies, domains, secrets, provider payloads, or customer account labels in kit output.",
+        "Seed writes are workspace-private and require explicit operator approval plus Supabase service credentials."
+      ]
+    },
+    next_actions: [
+      "Run memory_status before plan/proof so missing strategy coverage is visible.",
+      `Run seed_dry_run and inspect ${seedManifestFile} before any memory write.`,
+      "Use write_request to save the reusable campaign request, then run proof with no spend.",
+      "Add BYO tools through campaign-agent --custom-tool only after route setup is reviewed."
+    ]
+  };
+}
 function createCampaignBuilderToolRoute(input) {
   return {
     provider: input.provider ?? "custom_mcp",
@@ -2390,6 +2693,142 @@ function createCampaignBuilderToolRoute(input) {
     rationale: `${input.label ?? input.provider ?? "Custom tool"} is a user-provided campaign-builder route for ${input.layer}.`
   };
 }
+function campaignBuilderBuildKitMcpArgs(request) {
+  return compact({
+    goal: request.goal,
+    campaign_brief: request.goal,
+    campaign_name: request.campaignName,
+    account_label: request.accountLabel,
+    account_context: request.accountContext,
+    strategy_template: request.strategyTemplate,
+    operating_playbooks: request.operatingPlaybooks,
+    target_icp: request.icp,
+    target_count: request.targetCount,
+    builtins: request.builtIns,
+    include_local_leads: request.builtIns?.includes("local_leads") || void 0,
+    preferred_providers: request.preferredProviders,
+    custom_tools: request.integrations?.map((route) => compact({
+      provider: route.provider,
+      layer: route.layer,
+      gtm_layers: route.gtmLayers ?? (route.gtmLayer ? [route.gtmLayer] : void 0),
+      tool: route.toolName,
+      mcp: route.mcpServerName,
+      mode: route.mode,
+      approval_required: route.approvalRequired
+    })),
+    include_nango_catalog: request.agencyContext?.includeNangoCatalog,
+    include_memory: request.memory?.enabled,
+    include_brain: true,
+    include_provider_routes: true,
+    include_delivery_risk: true
+  });
+}
+function campaignBuilderBuildKitSdkExample(request, requestFile) {
+  const proofRequest = {
+    goal: request.goal,
+    strategyTemplate: request.strategyTemplate,
+    targetCount: request.targetCount,
+    builtIns: request.builtIns,
+    integrations: request.integrations
+  };
+  return [
+    "import { Signaliz, createCampaignBuilderBuildKit } from '@signaliz/sdk';",
+    "",
+    `const kit = createCampaignBuilderBuildKit({ requestFile: ${JSON.stringify(requestFile)}, ...${JSON.stringify(proofRequest, null, 2)} });`,
+    "console.log(kit.cli_commands.find((command) => command.id === 'proof_shortcut')?.command);",
+    "",
+    "const signaliz = new Signaliz({ apiKey: process.env.SIGNALIZ_API_KEY! });",
+    "const proof = await signaliz.campaignBuilderAgent.proof(kit.request, {",
+    "  idempotencyKey: `campaign-agent-proof-${Date.now()}`,",
+    "});",
+    "",
+    'if (!proof.success || proof.dry_run_result?.status !== "dry_run") {',
+    "  throw new Error('Campaign proof failed or launched work unexpectedly');",
+    "}"
+  ].join("\n");
+}
+function campaignBuilderMemoryKitSdkExample(request, seedManifestFile) {
+  const input = {
+    goal: request.goal,
+    strategyTemplate: request.strategyTemplate,
+    targetCount: request.targetCount,
+    builtIns: request.builtIns
+  };
+  return [
+    "import { Signaliz, createCampaignBuilderMemoryKit } from '@signaliz/sdk';",
+    "",
+    `const kit = createCampaignBuilderMemoryKit({ seedManifestFile: ${JSON.stringify(seedManifestFile)}, ...${JSON.stringify(input, null, 2)} });`,
+    "console.log(kit.cli_commands.find((command) => command.id === 'memory_status')?.command);",
+    "",
+    "const signaliz = new Signaliz({ apiKey: process.env.SIGNALIZ_API_KEY! });",
+    "const status = await signaliz.gtm.campaignStrategyMemoryStatus({",
+    "  strategyTemplate: kit.request.strategyTemplate,",
+    "  campaignBrief: kit.request.goal,",
+    "  includeSources: true,",
+    "  includeSamples: false,",
+    "});",
+    "",
+    "if (status?.ready === false) {",
+    "  throw new Error('Strategy memory is not ready for this campaign request');",
+    "}"
+  ].join("\n");
+}
+function campaignBuilderMemoryKitSource(source) {
+  const normalized = normalizeTemplateKey(source || "agency");
+  const catalog = {
+    agency: {
+      id: "agency_campaign_builder",
+      label: "Agency campaign-builder strategy patterns",
+      seed_source: "agency",
+      scope: "private_strategy_docs",
+      privacy: "workspace-private sanitized docs and abstracted campaign summaries"
+    },
+    workflow: {
+      id: "workflow_pattern_corpus",
+      label: "Workflow and table-build pattern corpus",
+      seed_source: "building-clay",
+      scope: "read_only_workflow_docs",
+      privacy: "sanitized operating model and workflow patterns"
+    },
+    feedback: {
+      id: "campaign_feedback",
+      label: "Campaign feedback and reply patterns",
+      seed_source: "instantly",
+      scope: "workspace_private_feedback",
+      privacy: "aggregate feedback, reply, and sequence performance memory"
+    }
+  };
+  const sourceMap = {
+    agency: "agency",
+    "campaign-builder": "agency",
+    "strategy-memory": "agency",
+    "workflow-patterns": "workflow",
+    workflow: "workflow",
+    "building-clay": "workflow",
+    clay: "workflow",
+    "instantly-feedback": "feedback",
+    instantly: "feedback",
+    feedback: "feedback",
+    all: "all"
+  };
+  const selected = sourceMap[normalized] || "agency";
+  if (selected === "all") {
+    return {
+      seedSource: "all",
+      verifyScript: null,
+      memorySources: [catalog.agency, catalog.workflow, catalog.feedback]
+    };
+  }
+  const item = catalog[selected];
+  return {
+    seedSource: item.seed_source,
+    verifyScript: item.seed_source === "agency" ? "scripts/gtm-kernel/verify-agency-import-manifest.mjs" : item.seed_source === "building-clay" ? "scripts/gtm-kernel/verify-building-clay-import-manifest.mjs" : null,
+    memorySources: [item]
+  };
+}
+function shellArg(value) {
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
 function normalizeTemplateKey(value) {
   return String(value || "").trim().toLowerCase().replace(/[_\s]+/g, "-");
 }
@@ -6739,7 +7178,7 @@ async function main() {
     printHelp();
     return;
   }
-  const offlineCampaignAgentTemplate = (command === "campaign-agent" || command === "campaign-builder") && ["init", "template", "request-template", "new"].includes(String(process.argv[3] || ""));
+  const offlineCampaignAgentTemplate = (command === "campaign-agent" || command === "campaign-builder") && ["init", "template", "request-template", "new", "kit", "build-kit", "blueprint", "memory-kit", "seed-kit", "memory"].includes(String(process.argv[3] || ""));
   if (!apiKey && !offlineCampaignAgentTemplate) {
     console.error("\u274C SIGNALIZ_API_KEY environment variable is required.");
     console.error("   Set it with: export SIGNALIZ_API_KEY=sk_...");
@@ -7103,6 +7542,73 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     }
     return;
   }
+  if (["kit", "build-kit", "blueprint"].includes(subcommand)) {
+    const flags2 = parseFlags(argv.slice(1));
+    const requestFromFile2 = campaignAgentRequestFileFromFlags(flags2);
+    const fallbackGoal = stringFlag(flags2, "goal", "brief") || stringOrUndefined(requestFromFile2?.goal) || "Build a strategy-template campaign for mature operators in the target ICP.";
+    const request2 = requestFromFile2 ? mergeCampaignAgentRequests(
+      requestFromFile2,
+      campaignAgentRequestFromFlags(fallbackGoal, flags2, { includeDefaults: false })
+    ) : campaignAgentRequestTemplateFromFlags(flags2);
+    const kit = createCampaignBuilderBuildKit({
+      ...request2,
+      includeLocalLeads: booleanFlag(flags2, "use-local-leads"),
+      includeCustomToolPlaceholder: booleanFlag(flags2, "with-byo-placeholder") || booleanFlag(flags2, "include-custom-tool-placeholder") || booleanFlag(flags2, "include-byo-placeholder"),
+      includeNango: !booleanFlag(flags2, "no-nango-catalog"),
+      requestFile: stringFlag(flags2, "request-output-file", "request-file-name") || stringFlag(flags2, "request-file") || "campaign-request.json",
+      cliPackage: stringFlag(flags2, "cli-package"),
+      sdkPackage: stringFlag(flags2, "sdk-package")
+    });
+    const outputFile = stringFlag(flags2, "output-file", "kit-file", "out");
+    if (outputFile) {
+      (0, import_node_fs.writeFileSync)(outputFile, `${JSON.stringify(kit, null, 2)}
+`, "utf8");
+    }
+    if (booleanFlag(flags2, "json")) {
+      printJson(kit);
+    } else if (!outputFile) {
+      printCampaignAgentBuildKit(kit);
+    } else {
+      console.log(`Campaign build kit written: ${outputFile}`);
+      console.log(`Next: ${kit.cli_commands.find((command) => command.id === "proof_shortcut")?.command}`);
+    }
+    return;
+  }
+  if (["memory-kit", "seed-kit", "memory"].includes(subcommand)) {
+    const flags2 = parseFlags(argv.slice(1));
+    const requestFromFile2 = campaignAgentRequestFileFromFlags(flags2);
+    const fallbackGoal = stringFlag(flags2, "goal", "brief") || stringOrUndefined(requestFromFile2?.goal) || "Build a strategy-template campaign for mature operators in the target ICP.";
+    const request2 = requestFromFile2 ? mergeCampaignAgentRequests(
+      requestFromFile2,
+      campaignAgentRequestFromFlags(fallbackGoal, flags2, { includeDefaults: false })
+    ) : campaignAgentRequestTemplateFromFlags(flags2);
+    const kit = createCampaignBuilderMemoryKit({
+      ...request2,
+      includeLocalLeads: booleanFlag(flags2, "use-local-leads"),
+      includeCustomToolPlaceholder: booleanFlag(flags2, "with-byo-placeholder") || booleanFlag(flags2, "include-custom-tool-placeholder") || booleanFlag(flags2, "include-byo-placeholder"),
+      includeNango: !booleanFlag(flags2, "no-nango-catalog"),
+      requestFile: stringFlag(flags2, "request-output-file", "request-file-name") || stringFlag(flags2, "request-file") || "campaign-request.json",
+      seedManifestFile: stringFlag(flags2, "seed-manifest-file", "manifest") || ".gtm-kernel-import-state/campaign-memory-dry-run.json",
+      source: stringFlag(flags2, "source", "memory-source", "seed-source"),
+      workspaceId: stringFlag(flags2, "workspace-id"),
+      cliPackage: stringFlag(flags2, "cli-package"),
+      sdkPackage: stringFlag(flags2, "sdk-package")
+    });
+    const outputFile = stringFlag(flags2, "output-file", "kit-file", "out");
+    if (outputFile) {
+      (0, import_node_fs.writeFileSync)(outputFile, `${JSON.stringify(kit, null, 2)}
+`, "utf8");
+    }
+    if (booleanFlag(flags2, "json")) {
+      printJson(kit);
+    } else if (!outputFile) {
+      printCampaignAgentMemoryKit(kit);
+    } else {
+      console.log(`Campaign memory kit written: ${outputFile}`);
+      console.log(`Next: ${kit.cli_commands.find((command) => command.id === "memory_status")?.command}`);
+    }
+    return;
+  }
   if (["review", "status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
     await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
     return;
@@ -7629,6 +8135,45 @@ function printCampaignAgentPlan(plan) {
     console.log(`- ${step.id}: ${step.tool}${step.approvalRequired ? " (approval required)" : ""}`);
   }
 }
+function printCampaignAgentBuildKit(kit) {
+  console.log(`Campaign build kit: ${kit.strategy_template || "custom strategy"}`);
+  console.log(`Request file: ${kit.request_file}`);
+  console.log(`Built-ins: ${kit.built_in_lanes.join(", ") || "none"}`);
+  console.log(`Playbooks: ${kit.operating_playbooks.join(", ") || "none"}`);
+  console.log(`BYO routes: ${kit.custom_routes.length}`);
+  console.log("\nCLI:");
+  for (const command of kit.cli_commands.slice(0, 4)) {
+    console.log(`- ${command.label}: ${command.command}`);
+  }
+  console.log("\nMCP:");
+  for (const call of kit.mcp_calls.slice(0, 3)) {
+    console.log(`- ${call.tool}: ${call.safety}`);
+  }
+  console.log("\nBYO tool pattern:");
+  console.log(`- ${kit.byo_tool_pattern.cli_flag}`);
+  console.log("\nNext:");
+  for (const action of kit.next_actions.slice(0, 4)) console.log(`- ${action}`);
+}
+function printCampaignAgentMemoryKit(kit) {
+  console.log(`Campaign memory kit: ${kit.strategy_template || "custom strategy"}`);
+  console.log(`Request file: ${kit.request_file}`);
+  console.log(`Seed manifest: ${kit.seed_manifest_file}`);
+  console.log(`Sources: ${kit.memory_sources.map((source) => source.id).join(", ") || "none"}`);
+  console.log(`Playbooks: ${kit.operating_playbooks.join(", ") || "none"}`);
+  console.log("\nCLI:");
+  for (const command of kit.cli_commands.slice(0, 4)) {
+    console.log(`- ${command.label}: ${command.command}`);
+  }
+  console.log("\nMCP:");
+  for (const call of kit.mcp_calls.slice(0, 3)) {
+    console.log(`- ${call.tool}: ${call.safety}`);
+  }
+  console.log("\nSeed runner:");
+  console.log(`- Dry run: ${kit.seed_runner.dry_run_command}`);
+  if (kit.seed_runner.verify_manifest_command) console.log(`- Verify: ${kit.seed_runner.verify_manifest_command}`);
+  console.log("\nNext:");
+  for (const action of kit.next_actions.slice(0, 4)) console.log(`- ${action}`);
+}
 function printCampaignAgentExecution(payload, flags) {
   if (booleanFlag(flags, "json")) {
     printJson(payload);
@@ -7789,6 +8334,7 @@ Usage:
   signaliz gtm memory search --query "proof-first vertical gate" --json
   signaliz gtm plan --brief "Build 500 verified leads for..." --strategy-template non-medical-home-care --lead-count 500 --json
   signaliz campaign-agent init --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json > campaign-request.json
+  signaliz campaign-agent memory-kit --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json
   signaliz campaign-agent doctor --request-file campaign-request.json --json
   signaliz campaign-agent plan --goal "Build a strategy-template campaign..." --strategy-template industrial-ot-resilience --target-count 500 --builtins lead_generation,email_finding,email_verification,signals
   signaliz campaign-agent proof --goal "Build a strategy-template campaign..." --strategy-template non-medical-home-care --target-count 100 --json
@@ -7826,6 +8372,8 @@ function printCampaignAgentHelp() {
 Signaliz campaign-agent commands:
 
   signaliz campaign-agent init [--goal TEXT] [--strategy-template ID] [--target-count N] [--use-local-leads] [--with-byo-placeholder] [--output-file FILE] [--json]
+  signaliz campaign-agent kit [--goal TEXT | --request-file FILE] [--strategy-template ID] [--target-count N] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--output-file FILE] [--json]
+  signaliz campaign-agent memory-kit [--goal TEXT | --request-file FILE] [--strategy-template ID] [--source agency|workflow-patterns|instantly-feedback|all] [--seed-manifest-file FILE] [--json]
   signaliz campaign-agent doctor [--goal TEXT | --request-file FILE] [--strategy-template ID] [--target-count N] [--builtins lead_generation,email_finding,email_verification,signals,local_leads] [--custom-tool provider:layer:tool[:mcp]] [--json]
   signaliz campaign-agent plan (--goal TEXT | --request-file FILE) [--campaign-name NAME] [--workspace-label NAME] [--strategy-template industrial-ot-resilience|non-medical-home-care|agency-founder-led|cloud-infrastructure-displacement] [--operating-playbooks proof-first-vertical-gate,signal-led-copy-approval] [--target-count N] [--icp JSON] [--builtins lead_generation,email_finding,email_verification,signals,local_leads] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--preferred-providers signaliz_native,octave] [--partners clay,instantly,nango] [--no-strategy-memory] [--no-kernel-plan] [--no-delivery-risk] [--json]
   signaliz campaign-agent proof (--goal TEXT | --request-file FILE) [--strategy-template ID] [--target-count N] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--idempotency-key KEY] [--json]
@@ -7838,7 +8386,7 @@ Signaliz campaign-agent commands:
   signaliz campaign-agent artifacts <campaign_build_id> [--json]
   signaliz campaign-agent approve <campaign_build_id> --destination-type json|csv|webhook [--destination-config JSON] [--json]
 
-The init command emits a reusable JSON CampaignBuilderAgentRequest. Doctor returns a readiness packet for built-in lanes, BYO routes, Memory, Brain, Kernel planning, and approval gates. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use review to inspect status, sampled rows, artifacts, and delivery-readiness gates before approving delivery or routing rows to external tools.
+The init command emits a reusable JSON CampaignBuilderAgentRequest. Kit emits the full build packet: request JSON, exact CLI commands, MCP calls, SDK example, approval boundaries, and BYO integration pattern. Doctor returns a readiness packet for built-in lanes, BYO routes, Memory, Brain, Kernel planning, and approval gates. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use review to inspect status, sampled rows, artifacts, and delivery-readiness gates before approving delivery or routing rows to external tools.
 `);
 }
 main().catch((e) => {