@signaliz/sdk 1.0.15 → 1.0.16

package/dist/mcp-config.js

@@ -1739,6 +1739,9 @@ var CampaignBuilderAgent = class {
   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) {
@@ -2452,6 +2455,12 @@ function createCampaignBuilderBuildKit(input = {}) {
         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",
@@ -2546,6 +2555,147 @@ function createCampaignBuilderBuildKit(input = {}) {
     ]
   };
 }
+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",
@@ -2615,6 +2765,85 @@ function campaignBuilderBuildKitSdkExample(request, requestFile) {
     "}"
   ].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, "'\\''")}'`;
 }

package/dist/mcp-config.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Signaliz
-} from "./chunk-6OZWMAV3.mjs";
+} from "./chunk-5JNKSMNW.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "Signaliz SDK — GTM Kernel, Nango routes, MCP, and enrichment for AI agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",