@nebutra/outreach-engine 0.1.1

package/README.md

@@ -0,0 +1,14 @@
+# @nebutra/outreach-engine
+
+Status: **WIP**
+
+Compliance-first outreach Play product.
+
+The package creates auditable campaign drafts. It does not own lead databases,
+email sender credentials, or CRM write adapters.
+
+```bash
+pnpm outreach-engine:doctor
+pnpm outreach-engine:quickstart "decision makers at mid-size D2C companies"
+pnpm outreach-engine:debug
+```

package/dist/chunk-ZH5KSGRI.js

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

package/dist/chunk-ZH5KSGRI.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 { 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 requireTenant(explicit: string | undefined, fallback: string | undefined): string {\n  const tenantId = explicit ?? fallback;\n  if (!tenantId?.trim()) {\n    throw 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  return tenantId;\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 = requireTenant(input.tenantId, this.#tenantId);\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.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,55 @@
+import {
+  OutreachEngine,
+  readOutreachEngineDebug
+} from "./chunk-ZH5KSGRI.js";
+
+// src/cli.ts
+var command = process.argv[2] ?? "doctor";
+var root = process.env.OUTREACH_ENGINE_ROOT ?? ".nebutra/outreach-engine";
+var 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)}
+`);
+  } 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
+      )}
+`
+    );
+  } finally {
+    await engine.close();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "outreach-engine", entries: await readOutreachEngineDebug() }, null, 2)}
+`
+  );
+} else {
+  process.stderr.write(`Unknown outreach-engine command: ${command}
+`);
+  process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { OutreachEngine, readOutreachEngineDebug } from \"./index\";\n\nconst command = process.argv[2] ?? \"doctor\";\nconst root = process.env.OUTREACH_ENGINE_ROOT ?? \".nebutra/outreach-engine\";\nconst tenantId = process.env.NEBUTRA_TENANT_ID ?? \"local\";\n\nif (command === \"doctor\") {\n  const engine = await OutreachEngine.open(root, { tenantId });\n  try {\n    process.stdout.write(`${JSON.stringify(await engine.doctor(), null, 2)}\\n`);\n  } finally {\n    await engine.close();\n  }\n} else if (command === \"quickstart\") {\n  const engine = await OutreachEngine.open(root, { tenantId });\n  try {\n    process.stdout.write(\n      `${JSON.stringify(\n        await engine.createCampaign({\n          tenantId,\n          icpDescription:\n            process.argv.slice(3).join(\" \") ||\n            \"decision makers at mid-size D2C e-commerce companies\",\n          targetCount: 10,\n          product: \"Loop helps teams debug production issues\",\n          sequenceLength: 3,\n          sendPerDay: 5,\n          senderEmails: [\"founder@loop.test\"],\n          complianceProfile: {\n            physicalAddress: \"123 Market St, San Francisco, CA\",\n            unsubscribeUrl: \"https://loop.test/unsubscribe\",\n            gdprBasis: \"legitimate_interest\",\n          },\n        }),\n        null,\n        2,\n      )}\\n`,\n    );\n  } finally {\n    await engine.close();\n  }\n} else if (command === \"debug\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"outreach-engine\", entries: await readOutreachEngineDebug() }, null, 2)}\\n`,\n  );\n} else {\n  process.stderr.write(`Unknown outreach-engine command: ${command}\\n`);\n  process.exitCode = 1;\n}\n"],"mappings":";;;;;;AAEA,IAAM,UAAU,QAAQ,KAAK,CAAC,KAAK;AACnC,IAAM,OAAO,QAAQ,IAAI,wBAAwB;AACjD,IAAM,WAAW,QAAQ,IAAI,qBAAqB;AAElD,IAAI,YAAY,UAAU;AACxB,QAAM,SAAS,MAAM,eAAe,KAAK,MAAM,EAAE,SAAS,CAAC;AAC3D,MAAI;AACF,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,MAAM,OAAO,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAAA,EAC5E,UAAE;AACA,UAAM,OAAO,MAAM;AAAA,EACrB;AACF,WAAW,YAAY,cAAc;AACnC,QAAM,SAAS,MAAM,eAAe,KAAK,MAAM,EAAE,SAAS,CAAC;AAC3D,MAAI;AACF,YAAQ,OAAO;AAAA,MACb,GAAG,KAAK;AAAA,QACN,MAAM,OAAO,eAAe;AAAA,UAC1B;AAAA,UACA,gBACE,QAAQ,KAAK,MAAM,CAAC,EAAE,KAAK,GAAG,KAC9B;AAAA,UACF,aAAa;AAAA,UACb,SAAS;AAAA,UACT,gBAAgB;AAAA,UAChB,YAAY;AAAA,UACZ,cAAc,CAAC,mBAAmB;AAAA,UAClC,mBAAmB;AAAA,YACjB,iBAAiB;AAAA,YACjB,gBAAgB;AAAA,YAChB,WAAW;AAAA,UACb;AAAA,QACF,CAAC;AAAA,QACD;AAAA,QACA;AAAA,MACF,CAAC;AAAA;AAAA,IACH;AAAA,EACF,UAAE;AACA,UAAM,OAAO,MAAM;AAAA,EACrB;AACF,WAAW,YAAY,SAAS;AAC9B,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,mBAAmB,SAAS,MAAM,wBAAwB,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EACzG;AACF,OAAO;AACL,UAAQ,OAAO,MAAM,oCAAoC,OAAO;AAAA,CAAI;AACpE,UAAQ,WAAW;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+import { ContentStore } from '@nebutra/content-store';
+import { EventLog } from '@nebutra/event-log';
+
+interface IcpDefinition {
+    readonly industries: readonly string[];
+    readonly companySize: {
+        readonly min: number;
+        readonly max: number;
+    };
+    readonly titles: readonly string[];
+    readonly geo: readonly string[];
+    readonly techStack: readonly string[];
+}
+interface ComplianceProfile {
+    readonly physicalAddress: string;
+    readonly unsubscribeUrl: string;
+    readonly gdprBasis?: "legitimate_interest" | "consent" | "existing_customer";
+}
+interface EmailVariant {
+    readonly step: number;
+    readonly subject: string;
+    readonly body: string;
+    readonly daysAfterPrevious: number;
+}
+interface ComplianceReport {
+    readonly ok: boolean;
+    readonly checks: {
+        readonly hasUnsubscribeLink: boolean;
+        readonly hasPhysicalAddress: boolean;
+        readonly hasClearSubject: boolean;
+        readonly gdprBasisDocumented: boolean;
+    };
+    readonly suggestion?: string;
+}
+interface CampaignInput {
+    readonly tenantId?: string;
+    readonly icpDescription: string;
+    readonly targetCount: number;
+    readonly product: string;
+    readonly sequenceLength: number;
+    readonly sendPerDay: number;
+    readonly senderEmails: readonly string[];
+    readonly complianceProfile: ComplianceProfile;
+}
+interface Lead {
+    readonly id: string;
+    readonly company: string;
+    readonly title: string;
+    readonly source: "local-plan";
+    readonly confidence: number;
+}
+interface CampaignPackage {
+    readonly tenantId: string;
+    readonly play: "outreach_campaign";
+    readonly id: string;
+    readonly status: "draft";
+    readonly icp: IcpDefinition;
+    readonly leads: readonly Lead[];
+    readonly sequence: readonly EmailVariant[];
+    readonly compliance: ComplianceReport;
+    readonly schedule: {
+        readonly dailyLimit: number;
+        readonly senderEmails: readonly string[];
+        readonly requiresApprovalBeforeSend: true;
+    };
+    readonly artifactPath: string;
+    readonly eventId: string;
+}
+interface SequenceInput {
+    readonly product: string;
+    readonly sequenceLength: number;
+    readonly brandVoice?: readonly string[];
+}
+interface OutreachDoctorReport {
+    readonly capability: "outreach-engine";
+    readonly ok: boolean;
+    readonly checkedAt: string;
+    readonly plays: readonly string[];
+    readonly sendMode: "draft-only";
+    readonly adapters: readonly {
+        readonly provider: string;
+        readonly ok: boolean;
+    }[];
+}
+interface OutreachEngineOptions {
+    readonly tenantId?: string;
+    readonly root?: string;
+    readonly debugRoot?: string;
+    readonly contentStore?: ContentStore;
+    readonly eventLog?: EventLog;
+}
+declare function defineIcp(description: string): IcpDefinition;
+declare function buildEmailSequence(input: SequenceInput): readonly EmailVariant[];
+declare function checkEmailCompliance(email: EmailVariant | undefined, profile: ComplianceProfile): ComplianceReport;
+declare class OutreachEngine {
+    #private;
+    private constructor();
+    static open(root?: string, options?: Omit<OutreachEngineOptions, "root" | "contentStore" | "eventLog">): Promise<OutreachEngine>;
+    createCampaign(input: CampaignInput): Promise<CampaignPackage>;
+    doctor(): Promise<OutreachDoctorReport>;
+    close(): Promise<void>;
+}
+declare function readOutreachEngineDebug(root?: string, limit?: number): Promise<unknown[]>;
+
+export { type CampaignInput, type CampaignPackage, type ComplianceProfile, type ComplianceReport, type EmailVariant, type IcpDefinition, type Lead, type OutreachDoctorReport, OutreachEngine, type OutreachEngineOptions, type SequenceInput, buildEmailSequence, checkEmailCompliance, defineIcp, readOutreachEngineDebug };

package/dist/index.js

@@ -0,0 +1,15 @@
+import {
+  OutreachEngine,
+  buildEmailSequence,
+  checkEmailCompliance,
+  defineIcp,
+  readOutreachEngineDebug
+} from "./chunk-ZH5KSGRI.js";
+export {
+  OutreachEngine,
+  buildEmailSequence,
+  checkEmailCompliance,
+  defineIcp,
+  readOutreachEngineDebug
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/examples/compliance.ts

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,30 @@
+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/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@nebutra/outreach-engine",
+  "version": "0.1.1",
+  "description": "Compliance-first outreach campaign Play package for founder-led sales workflows",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "nebutra": {
+    "status": "wip",
+    "productionReady": false,
+    "surface": "play-product",
+    "requires": [
+      "@nebutra/play-loader for SKILL.md play parsing",
+      "@nebutra/generation-context for product voice",
+      "@nebutra/content-store for campaign file truth",
+      "@nebutra/event-log for campaign checkpoints"
+    ],
+    "gaps": [
+      "Lead sourcing uses deterministic local planning until integration-vault lead providers are configured",
+      "Send operations are draft-only until sender adapters and explicit approval are wired"
+    ],
+    "featureId": "outreach-engine",
+    "category": "ai",
+    "summary": "Compliance-first outreach Play product that produces auditable campaign drafts"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@nebutra/capability-kit": "0.2.0",
+    "@nebutra/content-store": "0.1.0",
+    "@nebutra/errors": "0.1.0",
+    "@nebutra/event-log": "0.1.0",
+    "@nebutra/generation-context": "0.1.0",
+    "@nebutra/play-loader": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4"
+  },
+  "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/ai/outreach-engine#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nebutra/Nebutra-Sailor.git",
+    "directory": "packages/ai/outreach-engine"
+  },
+  "bugs": {
+    "url": "https://github.com/Nebutra/Nebutra-Sailor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/plays/outreach_campaign/SKILL.md

@@ -0,0 +1,44 @@
+---
+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

@@ -0,0 +1,49 @@
+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;
+}