@nebutra/outreach-engine 0.1.2 → 0.1.4

package/dist/{chunk-IY3N4YTP.js → chunk-XD3Y5BKC.js}

@@ -8,7 +8,7 @@ import { CapabilityError } from "@nebutra/errors";
 import { EventLog } from "@nebutra/event-log";
 import { assetId } from "@nebutra/generation-context";
 function slug(value) {
-  return value.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 48);
+  return value.slice(0, 200).toLowerCase().replace(/[^a-z0-9]{1,200}/g, "_").replace(/^_{1,200}|_{1,200}$/g, "").slice(0, 48);
 }
 function defineIcp(description) {
   const text = description.toLowerCase();
@@ -184,4 +184,4 @@ export {
   OutreachEngine,
   readOutreachEngineDebug
 };
-//# sourceMappingURL=chunk-IY3N4YTP.js.map
+//# sourceMappingURL=chunk-XD3Y5BKC.js.map

package/dist/chunk-XD3Y5BKC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport { requireCapabilityTenant } from \"@nebutra/capability-kit\";\nimport { appendCapabilityDebug, readCapabilityDebug } from \"@nebutra/capability-kit/debug\";\nimport { ContentStore } from \"@nebutra/content-store\";\nimport { CapabilityError } from \"@nebutra/errors\";\nimport { EventLog } from \"@nebutra/event-log\";\nimport { assetId } from \"@nebutra/generation-context\";\n\nexport interface IcpDefinition {\n  readonly industries: readonly string[];\n  readonly companySize: { readonly min: number; readonly max: number };\n  readonly titles: readonly string[];\n  readonly geo: readonly string[];\n  readonly techStack: readonly string[];\n}\n\nexport interface ComplianceProfile {\n  readonly physicalAddress: string;\n  readonly unsubscribeUrl: string;\n  readonly gdprBasis?: \"legitimate_interest\" | \"consent\" | \"existing_customer\";\n}\n\nexport interface EmailVariant {\n  readonly step: number;\n  readonly subject: string;\n  readonly body: string;\n  readonly daysAfterPrevious: number;\n}\n\nexport interface ComplianceReport {\n  readonly ok: boolean;\n  readonly checks: {\n    readonly hasUnsubscribeLink: boolean;\n    readonly hasPhysicalAddress: boolean;\n    readonly hasClearSubject: boolean;\n    readonly gdprBasisDocumented: boolean;\n  };\n  readonly suggestion?: string;\n}\n\nexport interface CampaignInput {\n  readonly tenantId?: string;\n  readonly icpDescription: string;\n  readonly targetCount: number;\n  readonly product: string;\n  readonly sequenceLength: number;\n  readonly sendPerDay: number;\n  readonly senderEmails: readonly string[];\n  readonly complianceProfile: ComplianceProfile;\n}\n\nexport interface Lead {\n  readonly id: string;\n  readonly company: string;\n  readonly title: string;\n  readonly source: \"local-plan\";\n  readonly confidence: number;\n}\n\nexport interface CampaignPackage {\n  readonly tenantId: string;\n  readonly play: \"outreach_campaign\";\n  readonly id: string;\n  readonly status: \"draft\";\n  readonly icp: IcpDefinition;\n  readonly leads: readonly Lead[];\n  readonly sequence: readonly EmailVariant[];\n  readonly compliance: ComplianceReport;\n  readonly schedule: {\n    readonly dailyLimit: number;\n    readonly senderEmails: readonly string[];\n    readonly requiresApprovalBeforeSend: true;\n  };\n  readonly artifactPath: string;\n  readonly eventId: string;\n}\n\nexport interface SequenceInput {\n  readonly product: string;\n  readonly sequenceLength: number;\n  readonly brandVoice?: readonly string[];\n}\n\nexport interface OutreachDoctorReport {\n  readonly capability: \"outreach-engine\";\n  readonly ok: boolean;\n  readonly checkedAt: string;\n  readonly plays: readonly string[];\n  readonly sendMode: \"draft-only\";\n  readonly adapters: readonly { readonly provider: string; readonly ok: boolean }[];\n}\n\nexport interface OutreachEngineOptions {\n  readonly tenantId?: string;\n  readonly root?: string;\n  readonly debugRoot?: string;\n  readonly contentStore?: ContentStore;\n  readonly eventLog?: EventLog;\n}\n\nfunction slug(value: string): string {\n  return value\n    .slice(0, 200)\n    .toLowerCase()\n    .replace(/[^a-z0-9]{1,200}/g, \"_\")\n    .replace(/^_{1,200}|_{1,200}$/g, \"\")\n    .slice(0, 48);\n}\n\nexport function defineIcp(description: string): IcpDefinition {\n  const text = description.toLowerCase();\n  const industries =\n    text.includes(\"e-commerce\") || text.includes(\"d2c\")\n      ? [\"e-commerce\", \"D2C\"]\n      : text.includes(\"saas\")\n        ? [\"SaaS\"]\n        : [\"startup\"];\n  const titles = text.includes(\"cto\")\n    ? [\"CTO\", \"VP Engineering\", \"Head of Engineering\"]\n    : [\"VP Marketing\", \"Head of Growth\", \"CMO\"];\n  const companySize =\n    text.includes(\"mid-size\") || text.includes(\"medium\")\n      ? { min: 50, max: 500 }\n      : { min: 1, max: 50 };\n  const geo = text.includes(\"eu\") ? [\"EU\"] : text.includes(\"us\") ? [\"US\"] : [\"US\", \"EU\"];\n  const techStack = text.includes(\"shopify\") ? [\"Shopify\"] : [];\n  return { industries, companySize, titles, geo, techStack };\n}\n\nexport function buildEmailSequence(input: SequenceInput): readonly EmailVariant[] {\n  const length = Math.max(1, Math.min(5, input.sequenceLength));\n  const voice = input.brandVoice?.join(\", \") ?? \"clear, useful\";\n  return Array.from({ length }, (_, index) => {\n    const step = index + 1;\n    return {\n      step,\n      subject: step === 1 ? \"Quick question\" : `Following up ${step}`,\n      body: [\n        `Hi {{first_name}},`,\n        \"\",\n        step === 1\n          ? `I noticed {{company}} may care about ${input.product}.`\n          : `Sharing one more angle on ${input.product}.`,\n        `Tone: ${voice}.`,\n        \"\",\n        \"If this is not useful, unsubscribe here: {{unsubscribe_url}}.\",\n        \"{{physical_address}}\",\n      ].join(\"\\n\"),\n      daysAfterPrevious: step === 1 ? 0 : step + 1,\n    };\n  });\n}\n\nexport function checkEmailCompliance(\n  email: EmailVariant | undefined,\n  profile: ComplianceProfile,\n): ComplianceReport {\n  const body = email?.body ?? \"\";\n  const checks = {\n    hasUnsubscribeLink: body.includes(\"unsubscribe\") && profile.unsubscribeUrl.startsWith(\"http\"),\n    hasPhysicalAddress: profile.physicalAddress.trim().length > 4,\n    hasClearSubject: Boolean(email?.subject.trim()),\n    gdprBasisDocumented: Boolean(profile.gdprBasis),\n  };\n  const ok = Object.values(checks).every(Boolean);\n  return {\n    ok,\n    checks,\n    ...(!ok\n      ? {\n          suggestion:\n            \"Add unsubscribe URL, physical address, clear subject, and GDPR basis before any send adapter can run.\",\n        }\n      : {}),\n  };\n}\n\nfunction plannedLeads(icp: IcpDefinition, count: number): readonly Lead[] {\n  const size = Math.max(1, Math.min(250, count));\n  return Array.from({ length: size }, (_, index) => ({\n    id: `lead_${String(index + 1).padStart(3, \"0\")}`,\n    company: `${icp.industries[0] ?? \"startup\"} account ${index + 1}`,\n    title: icp.titles[index % icp.titles.length] ?? \"Founder\",\n    source: \"local-plan\",\n    confidence: 0.72,\n  }));\n}\n\nexport class OutreachEngine {\n  readonly #tenantId: string | undefined;\n  readonly #debugRoot: string;\n  readonly #contentStore: ContentStore;\n  readonly #eventLog: EventLog;\n\n  private constructor(\n    options: OutreachEngineOptions & { contentStore: ContentStore; eventLog: EventLog },\n  ) {\n    this.#tenantId = options.tenantId;\n    this.#debugRoot = options.debugRoot ?? process.cwd();\n    this.#contentStore = options.contentStore;\n    this.#eventLog = options.eventLog;\n  }\n\n  static async open(\n    root = \".nebutra/outreach-engine\",\n    options: Omit<OutreachEngineOptions, \"root\" | \"contentStore\" | \"eventLog\"> = {},\n  ): Promise<OutreachEngine> {\n    const tenantId = options.tenantId ?? \"local\";\n    await mkdir(root, { recursive: true });\n    const contentStore = await ContentStore.open(join(root, \"content\"), { tenantId });\n    const eventLog = await EventLog.open(join(root, \"event-log\"), { tenantId });\n    return new OutreachEngine({ ...options, tenantId, root, contentStore, eventLog });\n  }\n\n  async createCampaign(input: CampaignInput): Promise<CampaignPackage> {\n    const tenantId = requireCapabilityTenant({\n      explicit: input.tenantId,\n      fallback: this.#tenantId,\n      onMissing: () =>\n        new CapabilityError(\"outreach-engine\", \"Outreach Engine requires tenant context\", {\n          suggestion: \"Pass tenantId before creating or persisting a campaign.\",\n          statusCode: 400,\n        }),\n    });\n    const icp = defineIcp(input.icpDescription);\n    const sequence = buildEmailSequence({\n      product: input.product,\n      sequenceLength: input.sequenceLength,\n      brandVoice: [\"specific\", \"useful\", \"respectful\"],\n    });\n    const compliance = checkEmailCompliance(sequence[0], input.complianceProfile);\n    if (!compliance.ok) {\n      throw new CapabilityError(\"outreach-engine\", \"Campaign failed compliance checks\", {\n        suggestion:\n          compliance.suggestion ??\n          \"Add unsubscribe URL, physical address, clear subject, and GDPR basis.\",\n        statusCode: 400,\n        metadata: compliance.checks,\n      });\n    }\n    const id = assetId(\"outreach_campaign\", slug(input.icpDescription));\n    const leads = plannedLeads(icp, input.targetCount);\n    const artifactPath = `outreach/${id}.json`;\n    const draft = {\n      id,\n      status: \"draft\",\n      icp,\n      leads,\n      sequence,\n      schedule: {\n        dailyLimit: Math.max(1, Math.min(30, input.sendPerDay)),\n        senderEmails: input.senderEmails,\n        requiresApprovalBeforeSend: true,\n      } as const,\n    };\n    const content = `${JSON.stringify(draft, null, 2)}\\n`;\n    await this.#contentStore.write(artifactPath, content);\n    const eventId = await this.#eventLog.commit({\n      traceId: id,\n      kind: \"content_write\",\n      affected: [artifactPath],\n      parent: null,\n      snapshot: { [artifactPath]: content },\n    });\n    const campaign: CampaignPackage = {\n      tenantId,\n      play: \"outreach_campaign\",\n      id,\n      status: \"draft\",\n      icp,\n      leads,\n      sequence,\n      compliance,\n      schedule: draft.schedule,\n      artifactPath,\n      eventId,\n    };\n    await this.#debug({ type: \"campaign_draft\", tenantId, campaignId: id, eventId });\n    return campaign;\n  }\n\n  async doctor(): Promise<OutreachDoctorReport> {\n    return {\n      capability: \"outreach-engine\",\n      ok: true,\n      checkedAt: new Date().toISOString(),\n      plays: [\"outreach_campaign\"],\n      sendMode: \"draft-only\",\n      adapters: [\n        { provider: \"local-plan\", ok: true },\n        { provider: \"integration-vault-email\", ok: false },\n        { provider: \"crm-sync\", ok: false },\n      ],\n    };\n  }\n\n  async close(): Promise<void> {\n    await this.#contentStore.close();\n  }\n\n  async #debug(entry: Record<string, unknown>): Promise<void> {\n    await mkdir(dirname(join(this.#debugRoot, \".nebutra\", \"debug\", \"outreach-engine.jsonl\")), {\n      recursive: true,\n    });\n    await appendCapabilityDebug(\"outreach-engine\", entry, { root: this.#debugRoot });\n  }\n}\n\nexport async function readOutreachEngineDebug(\n  root = process.cwd(),\n  limit = 20,\n): Promise<unknown[]> {\n  return readCapabilityDebug(\"outreach-engine\", { root, limit });\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -1,7 +1,7 @@
 import {
   OutreachEngine,
   readOutreachEngineDebug
-} from "./chunk-IY3N4YTP.js";
+} from "./chunk-XD3Y5BKC.js";
 
 // src/cli.ts
 var command = process.argv[2] ?? "doctor";

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   checkEmailCompliance,
   defineIcp,
   readOutreachEngineDebug
-} from "./chunk-IY3N4YTP.js";
+} from "./chunk-XD3Y5BKC.js";
 export {
   OutreachEngine,
   buildEmailSequence,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/outreach-engine",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Compliance-first outreach campaign Play package for founder-led sales workflows",
   "private": false,
   "license": "MIT",
@@ -23,21 +23,25 @@
     "category": "ai",
     "summary": "Compliance-first outreach Play product that produces auditable campaign drafts"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "@nebutra/capability-kit": "0.2.1",
-    "@nebutra/content-store": "0.1.1",
-    "@nebutra/errors": "0.1.1",
-    "@nebutra/event-log": "0.1.1",
-    "@nebutra/generation-context": "0.1.1",
-    "@nebutra/play-loader": "0.1.1"
+    "@nebutra/capability-kit": "0.2.4",
+    "@nebutra/content-store": "0.1.4",
+    "@nebutra/errors": "0.1.2",
+    "@nebutra/event-log": "0.1.4",
+    "@nebutra/generation-context": "0.1.3",
+    "@nebutra/play-loader": "0.1.3"
   },
   "devDependencies": {
-    "@types/node": "^22.19.15",
+    "@types/node": "^25.9.1",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
@@ -55,6 +59,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.nebutra/debug/content-store.jsonl

@@ -1,3 +0,0 @@
-{"at":"2026-05-19T08:15:29.836Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-19T08:15:29.865Z","type":"write","tenantId":"tenant_a","path":"outreach/outreach_campaign_decision_makers_at_mid_size_d2c_e_commer_mpccyjow.json"}
-{"at":"2026-05-19T08:15:30.046Z","type":"reindex","tenantId":"tenant_a","files":0}

package/.nebutra/debug/event-log.jsonl

@@ -1 +0,0 @@
-{"at":"2026-05-19T08:15:29.894Z","traceId":"outreach_campaign_decision_makers_at_mid_size_d2c_e_commer_mpccyjow","kind":"content_write","affected":["outreach/outreach_campaign_decision_makers_at_mid_size_d2c_e_commer_mpccyjow.json"],"parent":null,"snapshot":{"outreach/outreach_campaign_decision_makers_at_mid_size_d2c_e_commer_mpccyjow.json":"{\n  \"id\": \"outreach_campaign_decision_makers_at_mid_size_d2c_e_commer_mpccyjow\",\n  \"status\": \"draft\",\n  \"icp\": {\n    \"industries\": [\n      \"e-commerce\",\n      \"D2C\"\n    ],\n    \"companySize\": {\n      \"min\": 50,\n      \"max\": 500\n    },\n    \"titles\": [\n      \"VP Marketing\",\n      \"Head of Growth\",\n      \"CMO\"\n    ],\n    \"geo\": [\n      \"US\",\n      \"EU\"\n    ],\n    \"techStack\": []\n  },\n  \"leads\": [\n    {\n      \"id\": \"lead_001\",\n      \"company\": \"e-commerce account 1\",\n      \"title\": \"VP Marketing\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_002\",\n      \"company\": \"e-commerce account 2\",\n      \"title\": \"Head of Growth\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_003\",\n      \"company\": \"e-commerce account 3\",\n      \"title\": \"CMO\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_004\",\n      \"company\": \"e-commerce account 4\",\n      \"title\": \"VP Marketing\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_005\",\n      \"company\": \"e-commerce account 5\",\n      \"title\": \"Head of Growth\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_006\",\n      \"company\": \"e-commerce account 6\",\n      \"title\": \"CMO\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_007\",\n      \"company\": \"e-commerce account 7\",\n      \"title\": \"VP Marketing\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_008\",\n      \"company\": \"e-commerce account 8\",\n      \"title\": \"Head of Growth\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_009\",\n      \"company\": \"e-commerce account 9\",\n      \"title\": \"CMO\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_010\",\n      \"company\": \"e-commerce account 10\",\n      \"title\": \"VP Marketing\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_011\",\n      \"company\": \"e-commerce account 11\",\n      \"title\": \"Head of Growth\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    },\n    {\n      \"id\": \"lead_012\",\n      \"company\": \"e-commerce account 12\",\n      \"title\": \"CMO\",\n      \"source\": \"local-plan\",\n      \"confidence\": 0.72\n    }\n  ],\n  \"sequence\": [\n    {\n      \"step\": 1,\n      \"subject\": \"Quick question\",\n      \"body\": \"Hi {{first_name}},\\n\\nI noticed {{company}} may care about Loop helps teams debug production issues.\\nTone: specific, useful, respectful.\\n\\nIf this is not useful, unsubscribe here: {{unsubscribe_url}}.\\n{{physical_address}}\",\n      \"daysAfterPrevious\": 0\n    },\n    {\n      \"step\": 2,\n      \"subject\": \"Following up 2\",\n      \"body\": \"Hi {{first_name}},\\n\\nSharing one more angle on Loop helps teams debug production issues.\\nTone: specific, useful, respectful.\\n\\nIf this is not useful, unsubscribe here: {{unsubscribe_url}}.\\n{{physical_address}}\",\n      \"daysAfterPrevious\": 3\n    },\n    {\n      \"step\": 3,\n      \"subject\": \"Following up 3\",\n      \"body\": \"Hi {{first_name}},\\n\\nSharing one more angle on Loop helps teams debug production issues.\\nTone: specific, useful, respectful.\\n\\nIf this is not useful, unsubscribe here: {{unsubscribe_url}}.\\n{{physical_address}}\",\n      \"daysAfterPrevious\": 4\n    }\n  ],\n  \"schedule\": {\n    \"dailyLimit\": 4,\n    \"senderEmails\": [\n      \"founder@loop.test\"\n    ],\n    \"requiresApprovalBeforeSend\": true\n  }\n}\n"},"id":"e1f0777672396d3d7112e2dd69a4c18749cd773ae637bf10a16aed25ef72010a","tenantId":"tenant_a","summary":"content_write touched 1 path(s)","objectHashes":["a67b080547435c86547169b5ba680605d93af81556f3f188d9c6ec3aef4a66e9"]}

package/.nebutra/debug/outreach-engine.jsonl

@@ -1 +0,0 @@
-{"at":"2026-05-19T08:15:29.905Z","type":"campaign_draft","tenantId":"tenant_a","campaignId":"outreach_campaign_decision_makers_at_mid_size_d2c_e_commer_mpccyjow","eventId":"e1f0777672396d3d7112e2dd69a4c18749cd773ae637bf10a16aed25ef72010a"}

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @nebutra/outreach-engine@0.1.2 build /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/outreach-engine
-> tsup
-
-CLI Building entry: src/cli.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/outreach-engine/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/cli.js                1.61 KB
-ESM dist/index.js              290.00 B
-ESM dist/chunk-IY3N4YTP.js     6.72 KB
-ESM dist/cli.js.map            2.75 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/chunk-IY3N4YTP.js.map 14.97 KB
-ESM ⚡️ Build success in 76ms
-DTS Build start
-DTS ⚡️ Build success in 10096ms
-DTS dist/cli.d.ts   13.00 B
-DTS dist/index.d.ts 3.69 KB

package/.turbo/turbo-test.log

@@ -1,15 +0,0 @@
-
-> @nebutra/outreach-engine@0.1.2 test /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/outreach-engine
-> vitest run
-
-
- RUN  v4.1.4 /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/outreach-engine
-
- ✓ src/index.test.ts (5 tests) 647ms
-     ✓ runs outreach_campaign as a draft with leads, sequence, schedule, and event  353ms
-
- Test Files  1 passed (1)
-      Tests  5 passed (5)
-   Start at  08:15:26
-   Duration  3.52s (transform 1.37s, setup 0ms, import 1.91s, tests 647ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/outreach-engine@0.1.2 typecheck /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/outreach-engine
-> tsc --noEmit
-

package/dist/chunk-IY3N4YTP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport { requireCapabilityTenant } from \"@nebutra/capability-kit\";\nimport { appendCapabilityDebug, readCapabilityDebug } from \"@nebutra/capability-kit/debug\";\nimport { ContentStore } from \"@nebutra/content-store\";\nimport { CapabilityError } from \"@nebutra/errors\";\nimport { EventLog } from \"@nebutra/event-log\";\nimport { assetId } from \"@nebutra/generation-context\";\n\nexport interface IcpDefinition {\n  readonly industries: readonly string[];\n  readonly companySize: { readonly min: number; readonly max: number };\n  readonly titles: readonly string[];\n  readonly geo: readonly string[];\n  readonly techStack: readonly string[];\n}\n\nexport interface ComplianceProfile {\n  readonly physicalAddress: string;\n  readonly unsubscribeUrl: string;\n  readonly gdprBasis?: \"legitimate_interest\" | \"consent\" | \"existing_customer\";\n}\n\nexport interface EmailVariant {\n  readonly step: number;\n  readonly subject: string;\n  readonly body: string;\n  readonly daysAfterPrevious: number;\n}\n\nexport interface ComplianceReport {\n  readonly ok: boolean;\n  readonly checks: {\n    readonly hasUnsubscribeLink: boolean;\n    readonly hasPhysicalAddress: boolean;\n    readonly hasClearSubject: boolean;\n    readonly gdprBasisDocumented: boolean;\n  };\n  readonly suggestion?: string;\n}\n\nexport interface CampaignInput {\n  readonly tenantId?: string;\n  readonly icpDescription: string;\n  readonly targetCount: number;\n  readonly product: string;\n  readonly sequenceLength: number;\n  readonly sendPerDay: number;\n  readonly senderEmails: readonly string[];\n  readonly complianceProfile: ComplianceProfile;\n}\n\nexport interface Lead {\n  readonly id: string;\n  readonly company: string;\n  readonly title: string;\n  readonly source: \"local-plan\";\n  readonly confidence: number;\n}\n\nexport interface CampaignPackage {\n  readonly tenantId: string;\n  readonly play: \"outreach_campaign\";\n  readonly id: string;\n  readonly status: \"draft\";\n  readonly icp: IcpDefinition;\n  readonly leads: readonly Lead[];\n  readonly sequence: readonly EmailVariant[];\n  readonly compliance: ComplianceReport;\n  readonly schedule: {\n    readonly dailyLimit: number;\n    readonly senderEmails: readonly string[];\n    readonly requiresApprovalBeforeSend: true;\n  };\n  readonly artifactPath: string;\n  readonly eventId: string;\n}\n\nexport interface SequenceInput {\n  readonly product: string;\n  readonly sequenceLength: number;\n  readonly brandVoice?: readonly string[];\n}\n\nexport interface OutreachDoctorReport {\n  readonly capability: \"outreach-engine\";\n  readonly ok: boolean;\n  readonly checkedAt: string;\n  readonly plays: readonly string[];\n  readonly sendMode: \"draft-only\";\n  readonly adapters: readonly { readonly provider: string; readonly ok: boolean }[];\n}\n\nexport interface OutreachEngineOptions {\n  readonly tenantId?: string;\n  readonly root?: string;\n  readonly debugRoot?: string;\n  readonly contentStore?: ContentStore;\n  readonly eventLog?: EventLog;\n}\n\nfunction slug(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\")\n    .slice(0, 48);\n}\n\nexport function defineIcp(description: string): IcpDefinition {\n  const text = description.toLowerCase();\n  const industries =\n    text.includes(\"e-commerce\") || text.includes(\"d2c\")\n      ? [\"e-commerce\", \"D2C\"]\n      : text.includes(\"saas\")\n        ? [\"SaaS\"]\n        : [\"startup\"];\n  const titles = text.includes(\"cto\")\n    ? [\"CTO\", \"VP Engineering\", \"Head of Engineering\"]\n    : [\"VP Marketing\", \"Head of Growth\", \"CMO\"];\n  const companySize =\n    text.includes(\"mid-size\") || text.includes(\"medium\")\n      ? { min: 50, max: 500 }\n      : { min: 1, max: 50 };\n  const geo = text.includes(\"eu\") ? [\"EU\"] : text.includes(\"us\") ? [\"US\"] : [\"US\", \"EU\"];\n  const techStack = text.includes(\"shopify\") ? [\"Shopify\"] : [];\n  return { industries, companySize, titles, geo, techStack };\n}\n\nexport function buildEmailSequence(input: SequenceInput): readonly EmailVariant[] {\n  const length = Math.max(1, Math.min(5, input.sequenceLength));\n  const voice = input.brandVoice?.join(\", \") ?? \"clear, useful\";\n  return Array.from({ length }, (_, index) => {\n    const step = index + 1;\n    return {\n      step,\n      subject: step === 1 ? \"Quick question\" : `Following up ${step}`,\n      body: [\n        `Hi {{first_name}},`,\n        \"\",\n        step === 1\n          ? `I noticed {{company}} may care about ${input.product}.`\n          : `Sharing one more angle on ${input.product}.`,\n        `Tone: ${voice}.`,\n        \"\",\n        \"If this is not useful, unsubscribe here: {{unsubscribe_url}}.\",\n        \"{{physical_address}}\",\n      ].join(\"\\n\"),\n      daysAfterPrevious: step === 1 ? 0 : step + 1,\n    };\n  });\n}\n\nexport function checkEmailCompliance(\n  email: EmailVariant | undefined,\n  profile: ComplianceProfile,\n): ComplianceReport {\n  const body = email?.body ?? \"\";\n  const checks = {\n    hasUnsubscribeLink: body.includes(\"unsubscribe\") && profile.unsubscribeUrl.startsWith(\"http\"),\n    hasPhysicalAddress: profile.physicalAddress.trim().length > 4,\n    hasClearSubject: Boolean(email?.subject.trim()),\n    gdprBasisDocumented: Boolean(profile.gdprBasis),\n  };\n  const ok = Object.values(checks).every(Boolean);\n  return {\n    ok,\n    checks,\n    ...(!ok\n      ? {\n          suggestion:\n            \"Add unsubscribe URL, physical address, clear subject, and GDPR basis before any send adapter can run.\",\n        }\n      : {}),\n  };\n}\n\nfunction plannedLeads(icp: IcpDefinition, count: number): readonly Lead[] {\n  const size = Math.max(1, Math.min(250, count));\n  return Array.from({ length: size }, (_, index) => ({\n    id: `lead_${String(index + 1).padStart(3, \"0\")}`,\n    company: `${icp.industries[0] ?? \"startup\"} account ${index + 1}`,\n    title: icp.titles[index % icp.titles.length] ?? \"Founder\",\n    source: \"local-plan\",\n    confidence: 0.72,\n  }));\n}\n\nexport class OutreachEngine {\n  readonly #tenantId: string | undefined;\n  readonly #debugRoot: string;\n  readonly #contentStore: ContentStore;\n  readonly #eventLog: EventLog;\n\n  private constructor(\n    options: OutreachEngineOptions & { contentStore: ContentStore; eventLog: EventLog },\n  ) {\n    this.#tenantId = options.tenantId;\n    this.#debugRoot = options.debugRoot ?? process.cwd();\n    this.#contentStore = options.contentStore;\n    this.#eventLog = options.eventLog;\n  }\n\n  static async open(\n    root = \".nebutra/outreach-engine\",\n    options: Omit<OutreachEngineOptions, \"root\" | \"contentStore\" | \"eventLog\"> = {},\n  ): Promise<OutreachEngine> {\n    const tenantId = options.tenantId ?? \"local\";\n    await mkdir(root, { recursive: true });\n    const contentStore = await ContentStore.open(join(root, \"content\"), { tenantId });\n    const eventLog = await EventLog.open(join(root, \"event-log\"), { tenantId });\n    return new OutreachEngine({ ...options, tenantId, root, contentStore, eventLog });\n  }\n\n  async createCampaign(input: CampaignInput): Promise<CampaignPackage> {\n    const tenantId = requireCapabilityTenant({\n      explicit: input.tenantId,\n      fallback: this.#tenantId,\n      onMissing: () =>\n        new CapabilityError(\"outreach-engine\", \"Outreach Engine requires tenant context\", {\n          suggestion: \"Pass tenantId before creating or persisting a campaign.\",\n          statusCode: 400,\n        }),\n    });\n    const icp = defineIcp(input.icpDescription);\n    const sequence = buildEmailSequence({\n      product: input.product,\n      sequenceLength: input.sequenceLength,\n      brandVoice: [\"specific\", \"useful\", \"respectful\"],\n    });\n    const compliance = checkEmailCompliance(sequence[0], input.complianceProfile);\n    if (!compliance.ok) {\n      throw new CapabilityError(\"outreach-engine\", \"Campaign failed compliance checks\", {\n        suggestion:\n          compliance.suggestion ??\n          \"Add unsubscribe URL, physical address, clear subject, and GDPR basis.\",\n        statusCode: 400,\n        metadata: compliance.checks,\n      });\n    }\n    const id = assetId(\"outreach_campaign\", slug(input.icpDescription));\n    const leads = plannedLeads(icp, input.targetCount);\n    const artifactPath = `outreach/${id}.json`;\n    const draft = {\n      id,\n      status: \"draft\",\n      icp,\n      leads,\n      sequence,\n      schedule: {\n        dailyLimit: Math.max(1, Math.min(30, input.sendPerDay)),\n        senderEmails: input.senderEmails,\n        requiresApprovalBeforeSend: true,\n      } as const,\n    };\n    const content = `${JSON.stringify(draft, null, 2)}\\n`;\n    await this.#contentStore.write(artifactPath, content);\n    const eventId = await this.#eventLog.commit({\n      traceId: id,\n      kind: \"content_write\",\n      affected: [artifactPath],\n      parent: null,\n      snapshot: { [artifactPath]: content },\n    });\n    const campaign: CampaignPackage = {\n      tenantId,\n      play: \"outreach_campaign\",\n      id,\n      status: \"draft\",\n      icp,\n      leads,\n      sequence,\n      compliance,\n      schedule: draft.schedule,\n      artifactPath,\n      eventId,\n    };\n    await this.#debug({ type: \"campaign_draft\", tenantId, campaignId: id, eventId });\n    return campaign;\n  }\n\n  async doctor(): Promise<OutreachDoctorReport> {\n    return {\n      capability: \"outreach-engine\",\n      ok: true,\n      checkedAt: new Date().toISOString(),\n      plays: [\"outreach_campaign\"],\n      sendMode: \"draft-only\",\n      adapters: [\n        { provider: \"local-plan\", ok: true },\n        { provider: \"integration-vault-email\", ok: false },\n        { provider: \"crm-sync\", ok: false },\n      ],\n    };\n  }\n\n  async close(): Promise<void> {\n    await this.#contentStore.close();\n  }\n\n  async #debug(entry: Record<string, unknown>): Promise<void> {\n    await mkdir(dirname(join(this.#debugRoot, \".nebutra\", \"debug\", \"outreach-engine.jsonl\")), {\n      recursive: true,\n    });\n    await appendCapabilityDebug(\"outreach-engine\", entry, { root: this.#debugRoot });\n  }\n}\n\nexport async function readOutreachEngineDebug(\n  root = process.cwd(),\n  limit = 20,\n): Promise<unknown[]> {\n  return readCapabilityDebug(\"outreach-engine\", { root, limit });\n}\n"],"mappings":";AAAA,SAAS,aAAa;AACtB,SAAS,SAAS,YAAY;AAC9B,SAAS,+BAA+B;AACxC,SAAS,uBAAuB,2BAA2B;AAC3D,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAChC,SAAS,gBAAgB;AACzB,SAAS,eAAe;AA8FxB,SAAS,KAAK,OAAuB;AACnC,SAAO,MACJ,YAAY,EACZ,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE,EACtB,MAAM,GAAG,EAAE;AAChB;AAEO,SAAS,UAAU,aAAoC;AAC5D,QAAM,OAAO,YAAY,YAAY;AACrC,QAAM,aACJ,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,KAAK,IAC9C,CAAC,cAAc,KAAK,IACpB,KAAK,SAAS,MAAM,IAClB,CAAC,MAAM,IACP,CAAC,SAAS;AAClB,QAAM,SAAS,KAAK,SAAS,KAAK,IAC9B,CAAC,OAAO,kBAAkB,qBAAqB,IAC/C,CAAC,gBAAgB,kBAAkB,KAAK;AAC5C,QAAM,cACJ,KAAK,SAAS,UAAU,KAAK,KAAK,SAAS,QAAQ,IAC/C,EAAE,KAAK,IAAI,KAAK,IAAI,IACpB,EAAE,KAAK,GAAG,KAAK,GAAG;AACxB,QAAM,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI;AACrF,QAAM,YAAY,KAAK,SAAS,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC;AAC5D,SAAO,EAAE,YAAY,aAAa,QAAQ,KAAK,UAAU;AAC3D;AAEO,SAAS,mBAAmB,OAA+C;AAChF,QAAM,SAAS,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,cAAc,CAAC;AAC5D,QAAM,QAAQ,MAAM,YAAY,KAAK,IAAI,KAAK;AAC9C,SAAO,MAAM,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,UAAU;AAC1C,UAAM,OAAO,QAAQ;AACrB,WAAO;AAAA,MACL;AAAA,MACA,SAAS,SAAS,IAAI,mBAAmB,gBAAgB,IAAI;AAAA,MAC7D,MAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA,SAAS,IACL,wCAAwC,MAAM,OAAO,MACrD,6BAA6B,MAAM,OAAO;AAAA,QAC9C,SAAS,KAAK;AAAA,QACd;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,MACX,mBAAmB,SAAS,IAAI,IAAI,OAAO;AAAA,IAC7C;AAAA,EACF,CAAC;AACH;AAEO,SAAS,qBACd,OACA,SACkB;AAClB,QAAM,OAAO,OAAO,QAAQ;AAC5B,QAAM,SAAS;AAAA,IACb,oBAAoB,KAAK,SAAS,aAAa,KAAK,QAAQ,eAAe,WAAW,MAAM;AAAA,IAC5F,oBAAoB,QAAQ,gBAAgB,KAAK,EAAE,SAAS;AAAA,IAC5D,iBAAiB,QAAQ,OAAO,QAAQ,KAAK,CAAC;AAAA,IAC9C,qBAAqB,QAAQ,QAAQ,SAAS;AAAA,EAChD;AACA,QAAM,KAAK,OAAO,OAAO,MAAM,EAAE,MAAM,OAAO;AAC9C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAI,CAAC,KACD;AAAA,MACE,YACE;AAAA,IACJ,IACA,CAAC;AAAA,EACP;AACF;AAEA,SAAS,aAAa,KAAoB,OAAgC;AACxE,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC;AAC7C,SAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,GAAG,CAAC,GAAG,WAAW;AAAA,IACjD,IAAI,QAAQ,OAAO,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC;AAAA,IAC9C,SAAS,GAAG,IAAI,WAAW,CAAC,KAAK,SAAS,YAAY,QAAQ,CAAC;AAAA,IAC/D,OAAO,IAAI,OAAO,QAAQ,IAAI,OAAO,MAAM,KAAK;AAAA,IAChD,QAAQ;AAAA,IACR,YAAY;AAAA,EACd,EAAE;AACJ;AAEO,IAAM,iBAAN,MAAM,gBAAe;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAED,YACN,SACA;AACA,SAAK,YAAY,QAAQ;AACzB,SAAK,aAAa,QAAQ,aAAa,QAAQ,IAAI;AACnD,SAAK,gBAAgB,QAAQ;AAC7B,SAAK,YAAY,QAAQ;AAAA,EAC3B;AAAA,EAEA,aAAa,KACX,OAAO,4BACP,UAA6E,CAAC,GACrD;AACzB,UAAM,WAAW,QAAQ,YAAY;AACrC,UAAM,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;AACrC,UAAM,eAAe,MAAM,aAAa,KAAK,KAAK,MAAM,SAAS,GAAG,EAAE,SAAS,CAAC;AAChF,UAAM,WAAW,MAAM,SAAS,KAAK,KAAK,MAAM,WAAW,GAAG,EAAE,SAAS,CAAC;AAC1E,WAAO,IAAI,gBAAe,EAAE,GAAG,SAAS,UAAU,MAAM,cAAc,SAAS,CAAC;AAAA,EAClF;AAAA,EAEA,MAAM,eAAe,OAAgD;AACnE,UAAM,WAAW,wBAAwB;AAAA,MACvC,UAAU,MAAM;AAAA,MAChB,UAAU,KAAK;AAAA,MACf,WAAW,MACT,IAAI,gBAAgB,mBAAmB,2CAA2C;AAAA,QAChF,YAAY;AAAA,QACZ,YAAY;AAAA,MACd,CAAC;AAAA,IACL,CAAC;AACD,UAAM,MAAM,UAAU,MAAM,cAAc;AAC1C,UAAM,WAAW,mBAAmB;AAAA,MAClC,SAAS,MAAM;AAAA,MACf,gBAAgB,MAAM;AAAA,MACtB,YAAY,CAAC,YAAY,UAAU,YAAY;AAAA,IACjD,CAAC;AACD,UAAM,aAAa,qBAAqB,SAAS,CAAC,GAAG,MAAM,iBAAiB;AAC5E,QAAI,CAAC,WAAW,IAAI;AAClB,YAAM,IAAI,gBAAgB,mBAAmB,qCAAqC;AAAA,QAChF,YACE,WAAW,cACX;AAAA,QACF,YAAY;AAAA,QACZ,UAAU,WAAW;AAAA,MACvB,CAAC;AAAA,IACH;AACA,UAAM,KAAK,QAAQ,qBAAqB,KAAK,MAAM,cAAc,CAAC;AAClE,UAAM,QAAQ,aAAa,KAAK,MAAM,WAAW;AACjD,UAAM,eAAe,YAAY,EAAE;AACnC,UAAM,QAAQ;AAAA,MACZ;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU;AAAA,QACR,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,UAAU,CAAC;AAAA,QACtD,cAAc,MAAM;AAAA,QACpB,4BAA4B;AAAA,MAC9B;AAAA,IACF;AACA,UAAM,UAAU,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AAAA;AACjD,UAAM,KAAK,cAAc,MAAM,cAAc,OAAO;AACpD,UAAM,UAAU,MAAM,KAAK,UAAU,OAAO;AAAA,MAC1C,SAAS;AAAA,MACT,MAAM;AAAA,MACN,UAAU,CAAC,YAAY;AAAA,MACvB,QAAQ;AAAA,MACR,UAAU,EAAE,CAAC,YAAY,GAAG,QAAQ;AAAA,IACtC,CAAC;AACD,UAAM,WAA4B;AAAA,MAChC;AAAA,MACA,MAAM;AAAA,MACN;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU,MAAM;AAAA,MAChB;AAAA,MACA;AAAA,IACF;AACA,UAAM,KAAK,OAAO,EAAE,MAAM,kBAAkB,UAAU,YAAY,IAAI,QAAQ,CAAC;AAC/E,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAwC;AAC5C,WAAO;AAAA,MACL,YAAY;AAAA,MACZ,IAAI;AAAA,MACJ,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,OAAO,CAAC,mBAAmB;AAAA,MAC3B,UAAU;AAAA,MACV,UAAU;AAAA,QACR,EAAE,UAAU,cAAc,IAAI,KAAK;AAAA,QACnC,EAAE,UAAU,2BAA2B,IAAI,MAAM;AAAA,QACjD,EAAE,UAAU,YAAY,IAAI,MAAM;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,QAAuB;AAC3B,UAAM,KAAK,cAAc,MAAM;AAAA,EACjC;AAAA,EAEA,MAAM,OAAO,OAA+C;AAC1D,UAAM,MAAM,QAAQ,KAAK,KAAK,YAAY,YAAY,SAAS,uBAAuB,CAAC,GAAG;AAAA,MACxF,WAAW;AAAA,IACb,CAAC;AACD,UAAM,sBAAsB,mBAAmB,OAAO,EAAE,MAAM,KAAK,WAAW,CAAC;AAAA,EACjF;AACF;AAEA,eAAsB,wBACpB,OAAO,QAAQ,IAAI,GACnB,QAAQ,IACY;AACpB,SAAO,oBAAoB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAC/D;","names":[]}

package/examples/compliance.ts

@@ -1,18 +0,0 @@
-import { buildEmailSequence, checkEmailCompliance } from "../src/index";
-
-const sequence = buildEmailSequence({
-  product: "Loop helps teams debug production issues",
-  sequenceLength: 2,
-});
-
-process.stdout.write(
-  `${JSON.stringify(
-    checkEmailCompliance(sequence[0], {
-      physicalAddress: "123 Market St",
-      unsubscribeUrl: "https://loop.test/unsubscribe",
-      gdprBasis: "legitimate_interest",
-    }),
-    null,
-    2,
-  )}\n`,
-);

package/examples/icp.ts

@@ -1,9 +0,0 @@
-import { defineIcp } from "../src/index";
-
-process.stdout.write(
-  `${JSON.stringify(
-    defineIcp("decision makers at mid-size D2C e-commerce companies in the US"),
-    null,
-    2,
-  )}\n`,
-);

package/examples/quickstart.ts

@@ -1,30 +0,0 @@
-import { OutreachEngine } from "../src/index";
-
-const engine = await OutreachEngine.open(".nebutra/outreach-engine-example", {
-  tenantId: "local",
-});
-
-try {
-  process.stdout.write(
-    `${JSON.stringify(
-      await engine.createCampaign({
-        tenantId: "local",
-        icpDescription: "decision makers at mid-size D2C e-commerce companies",
-        targetCount: 10,
-        product: "Loop helps teams debug production issues",
-        sequenceLength: 3,
-        sendPerDay: 5,
-        senderEmails: ["founder@loop.test"],
-        complianceProfile: {
-          physicalAddress: "123 Market St",
-          unsubscribeUrl: "https://loop.test/unsubscribe",
-          gdprBasis: "legitimate_interest",
-        },
-      }),
-      null,
-      2,
-    )}\n`,
-  );
-} finally {
-  await engine.close();
-}

package/plays/outreach_campaign/SKILL.md

@@ -1,44 +0,0 @@
----
-name: outreach_campaign
-kind: play
-version: 1.0.0
-description: Create a compliance-gated founder-led outbound campaign draft
-inputs:
-  icp_description: { type: string, max_length: 500 }
-  target_count: { type: number }
-  product: { type: string, max_length: 500 }
-  sequence_length: { type: number }
-  send_per_day: { type: number }
-outputs:
-  campaign: { type: file, path: outreach/campaign.json, mime: application/json }
-budget:
-  duration_s: 600
-  cost_usd: 2.0
-required_skills:
-  - content_store.write
-  - research_agent.run
-  - integration_vault.invoke
-sub_agents:
-  - role: icp_strategist
-    allowed_skills: [content_store.write]
-  - role: lead_researcher
-    allowed_skills: [research_agent.run]
-  - role: compliance_reviewer
-    allowed_skills: [content_store.write]
-depends_on_plays: []
----
-
-## What this play does
-
-Creates a draft outbound campaign from an ICP description.
-
-The Play is draft-first. It may produce leads, enrichment notes, email variants,
-and a schedule, but actual sending requires explicit approval and a configured
-sender adapter.
-
-## Rules
-
-- Never bypass unsubscribe, physical address, or consent basis checks.
-- Never send directly from the Play run.
-- Keep lead data tenant-scoped.
-- Write campaign artifacts through content-store.

package/src/cli.ts

@@ -1,49 +0,0 @@
-import { OutreachEngine, readOutreachEngineDebug } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const root = process.env.OUTREACH_ENGINE_ROOT ?? ".nebutra/outreach-engine";
-const tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
-
-if (command === "doctor") {
-  const engine = await OutreachEngine.open(root, { tenantId });
-  try {
-    process.stdout.write(`${JSON.stringify(await engine.doctor(), null, 2)}\n`);
-  } finally {
-    await engine.close();
-  }
-} else if (command === "quickstart") {
-  const engine = await OutreachEngine.open(root, { tenantId });
-  try {
-    process.stdout.write(
-      `${JSON.stringify(
-        await engine.createCampaign({
-          tenantId,
-          icpDescription:
-            process.argv.slice(3).join(" ") ||
-            "decision makers at mid-size D2C e-commerce companies",
-          targetCount: 10,
-          product: "Loop helps teams debug production issues",
-          sequenceLength: 3,
-          sendPerDay: 5,
-          senderEmails: ["founder@loop.test"],
-          complianceProfile: {
-            physicalAddress: "123 Market St, San Francisco, CA",
-            unsubscribeUrl: "https://loop.test/unsubscribe",
-            gdprBasis: "legitimate_interest",
-          },
-        }),
-        null,
-        2,
-      )}\n`,
-    );
-  } finally {
-    await engine.close();
-  }
-} else if (command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "outreach-engine", entries: await readOutreachEngineDebug() }, null, 2)}\n`,
-  );
-} else {
-  process.stderr.write(`Unknown outreach-engine command: ${command}\n`);
-  process.exitCode = 1;
-}

package/src/index.test.ts

@@ -1,120 +0,0 @@
-import { mkdtemp, readFile, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { parsePlayMarkdown } from "@nebutra/play-loader";
-import { afterEach, describe, expect, it } from "vitest";
-import {
-  buildEmailSequence,
-  checkEmailCompliance,
-  defineIcp,
-  OutreachEngine,
-  readOutreachEngineDebug,
-} from "./index";
-
-let root: string | undefined;
-let engine: OutreachEngine | undefined;
-
-afterEach(async () => {
-  if (engine) await engine.close();
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-  engine = undefined;
-});
-
-async function open(): Promise<OutreachEngine> {
-  root = await mkdtemp(join(tmpdir(), "outreach-engine-"));
-  engine = await OutreachEngine.open(root, { tenantId: "tenant_a" });
-  return engine;
-}
-
-describe("outreach-engine", () => {
-  it("turns fuzzy ICP language into a structured targeting plan", () => {
-    const icp = defineIcp("decision makers at mid-size D2C e-commerce companies in the US");
-
-    expect(icp.industries).toContain("e-commerce");
-    expect(icp.companySize).toEqual({ min: 50, max: 500 });
-    expect(icp.titles).toContain("Head of Growth");
-    expect(icp.geo).toContain("US");
-  });
-
-  it("builds compliance-gated email variants with unsubscribe requirements", () => {
-    const sequence = buildEmailSequence({
-      product: "Loop helps indie devs debug production issues",
-      sequenceLength: 3,
-      brandVoice: ["technical", "warm"],
-    });
-    const compliance = checkEmailCompliance(sequence[0], {
-      physicalAddress: "123 Market St, San Francisco, CA",
-      unsubscribeUrl: "https://loop.test/unsubscribe",
-      gdprBasis: "legitimate_interest",
-    });
-
-    expect(sequence).toHaveLength(3);
-    expect(sequence[0]?.body).toContain("unsubscribe");
-    expect(compliance.ok).toBe(true);
-  });
-
-  it("runs outreach_campaign as a draft with leads, sequence, schedule, and event", async () => {
-    const runtime = await open();
-
-    const campaign = await runtime.createCampaign({
-      tenantId: "tenant_a",
-      icpDescription: "decision makers at mid-size D2C e-commerce companies",
-      targetCount: 12,
-      product: "Loop helps teams debug production issues",
-      sequenceLength: 3,
-      sendPerDay: 4,
-      senderEmails: ["founder@loop.test"],
-      complianceProfile: {
-        physicalAddress: "123 Market St, San Francisco, CA",
-        unsubscribeUrl: "https://loop.test/unsubscribe",
-        gdprBasis: "legitimate_interest",
-      },
-    });
-
-    expect(campaign.play).toBe("outreach_campaign");
-    expect(campaign.status).toBe("draft");
-    expect(campaign.leads).toHaveLength(12);
-    expect(campaign.sequence).toHaveLength(3);
-    expect(campaign.schedule.dailyLimit).toBe(4);
-    expect(campaign.compliance.ok).toBe(true);
-    expect(campaign.eventId).toEqual(expect.any(String));
-    await expect(readOutreachEngineDebug(root)).resolves.toEqual(expect.any(Array));
-  });
-
-  it("rejects persistent campaign creation without tenant context", async () => {
-    const runtime = await open();
-
-    await expect(
-      runtime.createCampaign({
-        tenantId: "",
-        icpDescription: "SaaS CTOs",
-        targetCount: 5,
-        product: "Loop",
-        sequenceLength: 2,
-        sendPerDay: 2,
-        senderEmails: ["founder@loop.test"],
-        complianceProfile: {
-          physicalAddress: "123 Market St",
-          unsubscribeUrl: "https://loop.test/unsubscribe",
-          gdprBasis: "legitimate_interest",
-        },
-      }),
-    ).rejects.toMatchObject({
-      capability: "outreach-engine",
-      suggestion: expect.stringContaining("tenantId"),
-    });
-  });
-
-  it("keeps the outreach campaign as SKILL.md instead of a new workflow format", async () => {
-    const skill = await readFile(
-      join(process.cwd(), "plays", "outreach_campaign", "SKILL.md"),
-      "utf8",
-    );
-    const play = parsePlayMarkdown(skill);
-
-    expect(play.meta).toMatchObject({ name: "outreach_campaign", kind: "play" });
-    expect(play.requiredSkills).toContain("content_store.write");
-    expect(play.subAgents.map((agent) => agent.role)).toContain("lead_researcher");
-  });
-});