@hark-protocol/protocol 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @hark-protocol/protocol
+
+Shared Zod schemas, taxonomy, tinybar helpers, and constants for [Hark
+Protocol](https://github.com/SiddharthaMadhav/ETHOnline-2026) - an open
+intent-advertising protocol with x402 machine payments on Hedera.
+
+Publishers and advertising agents both build on these types: `Publisher`,
+`Placement`, `HarkIntent`, `Campaign`, `HarkOpportunity`, `Delivery`, and the
+`POST /v1/reach` request/response shapes, plus a small canonical topic
+taxonomy (`isSameOrDescendant`, `topicDistance`).
+
+```ts
+import { createIntentInputSchema, isSameOrDescendant } from "@hark-protocol/protocol";
+```
+
+An optional `@hark-protocol/protocol/hcs14` subpath computes a
+syntactically-valid HCS-14 "Universal Agent ID" - server-only (uses
+`node:crypto`), kept out of the main browser-safe barrel on purpose.
+
+Part of the [Hark Protocol](https://github.com/SiddharthaMadhav/ETHOnline-2026)
+monorepo. See that repo for the full protocol spec, API, and demo apps.

package/dist/constants.d.ts

@@ -0,0 +1,25 @@
+/** Public ID prefixes per CLAUDE.md section 50. */
+export declare const ID_PREFIX: {
+    readonly publisher: "pub_";
+    readonly placement: "plc_";
+    readonly intent: "int_";
+    readonly opportunity: "opp_";
+    readonly agent: "agt_";
+    readonly campaign: "cmp_";
+    readonly delivery: "del_";
+    readonly payment: "pay_";
+};
+export type IdKind = keyof typeof ID_PREFIX;
+/** Intent TTL rules per CLAUDE.md section 9. */
+export declare const INTENT_DEFAULT_TTL_SECONDS: number;
+export declare const INTENT_MAX_TTL_SECONDS: number;
+/** Opportunity TTL per CLAUDE.md section 13. */
+export declare const OPPORTUNITY_TTL_SECONDS: number;
+/** Semantic summary max length per CLAUDE.md section 9. */
+export declare const SEMANTIC_SUMMARY_MAX_LENGTH = 280;
+/** Payment network/asset defaults per CLAUDE.md section 5. */
+export declare const HEDERA_TESTNET_NETWORK: "hedera:testnet";
+export declare const HBAR_ASSET_ID: "0.0.0";
+export declare const HBAR_DECIMALS = 8;
+export declare const DEFAULT_REACH_PRICE_TINYBAR = "100000";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,eAAO,MAAM,SAAS;;;;;;;;;CASZ,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,SAAS,CAAC;AAE5C,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,QAAoB,CAAC;AAC5D,eAAO,MAAM,sBAAsB,QAAoB,CAAC;AAExD,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,2DAA2D;AAC3D,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,EAAG,gBAAyB,CAAC;AAChE,eAAO,MAAM,aAAa,EAAG,OAAgB,CAAC;AAC9C,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,2BAA2B,WAAW,CAAC"}

package/dist/constants.js

@@ -0,0 +1,24 @@
+/** Public ID prefixes per CLAUDE.md section 50. */
+export const ID_PREFIX = {
+    publisher: "pub_",
+    placement: "plc_",
+    intent: "int_",
+    opportunity: "opp_",
+    agent: "agt_",
+    campaign: "cmp_",
+    delivery: "del_",
+    payment: "pay_",
+};
+/** Intent TTL rules per CLAUDE.md section 9. */
+export const INTENT_DEFAULT_TTL_SECONDS = 30 * 24 * 60 * 60; // 30 days
+export const INTENT_MAX_TTL_SECONDS = 90 * 24 * 60 * 60; // 90 days
+/** Opportunity TTL per CLAUDE.md section 13. */
+export const OPPORTUNITY_TTL_SECONDS = 5 * 60; // 5 minutes
+/** Semantic summary max length per CLAUDE.md section 9. */
+export const SEMANTIC_SUMMARY_MAX_LENGTH = 280;
+/** Payment network/asset defaults per CLAUDE.md section 5. */
+export const HEDERA_TESTNET_NETWORK = "hedera:testnet";
+export const HBAR_ASSET_ID = "0.0.0";
+export const HBAR_DECIMALS = 8;
+export const DEFAULT_REACH_PRICE_TINYBAR = "100000";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;IACjB,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,MAAM;IACnB,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;CACP,CAAC;AAIX,gDAAgD;AAChD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU;AAEnE,gDAAgD;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,YAAY;AAE3D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAyB,CAAC;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,OAAgB,CAAC;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC"}

package/dist/hcs14.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Computes a syntactically-valid HCS-14 ("Universal Agent ID") identifier,
+ * per the published grammar at hol.org/docs/standards/hcs-14:
+ *
+ *   uaid:aid:{base58(sha384(canonicalJson))};uid=...;registry=...;proto=...;nativeId=...
+ *
+ * CLAUDE.md section 36 deliberately treats HCS-14 as optional and
+ * non-blocking, since it's still a draft standard with no stable public
+ * registry to integrate against. This computes a correctly-shaped id
+ * locally - it is NOT registered with, or resolvable via, any live
+ * Hashgraph Online (or other) HCS-14 registry. `registry`/`protocol` below
+ * are Hark's own self-declared namespace values, not officially assigned
+ * codes.
+ *
+ * Deliberately server-only (uses node:crypto) - imported via the
+ * `@hark-protocol/protocol/hcs14` subpath, not the package's main barrel, so
+ * it never ends up in a browser bundle (packages/protocol's main export is
+ * consumed by apps/web client components too).
+ */
+export type Hcs14AgentInput = {
+    /** Stable identifier within the registry, e.g. the agent's slug. */
+    uid: string;
+    name: string;
+    /** CAIP-10-shaped native chain identifier, e.g. "hedera:testnet:0.0.12345". */
+    nativeId: string;
+    registry?: string;
+    protocol?: string;
+    version?: string;
+    skills?: string[];
+};
+export declare function computeHcs14Id(input: Hcs14AgentInput): string;
+//# sourceMappingURL=hcs14.d.ts.map

package/dist/hcs14.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs14.d.ts","sourceRoot":"","sources":["../src/hcs14.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAkCF,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAkB7D"}

package/dist/hcs14.js

@@ -0,0 +1,45 @@
+import { createHash } from "node:crypto";
+const BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58Encode(bytes) {
+    const digits = [0];
+    for (const byte of bytes) {
+        let carry = byte;
+        for (let i = 0; i < digits.length; i += 1) {
+            carry += digits[i] * 256;
+            digits[i] = carry % 58;
+            carry = Math.floor(carry / 58);
+        }
+        while (carry > 0) {
+            digits.push(carry % 58);
+            carry = Math.floor(carry / 58);
+        }
+    }
+    let leadingZeros = 0;
+    for (const byte of bytes) {
+        if (byte !== 0)
+            break;
+        leadingZeros += 1;
+    }
+    return (BASE58_ALPHABET[0].repeat(leadingZeros) +
+        digits
+            .reverse()
+            .map((digit) => BASE58_ALPHABET[digit])
+            .join(""));
+}
+export function computeHcs14Id(input) {
+    const registry = input.registry ?? "hark-protocol";
+    const protocol = input.protocol ?? "hark-x402";
+    const version = input.version ?? "0.1.0";
+    const canonical = JSON.stringify({
+        registry,
+        name: input.name,
+        version,
+        protocol,
+        nativeId: input.nativeId,
+        skills: input.skills ?? [],
+    });
+    const hash = createHash("sha384").update(canonical).digest();
+    const id = base58Encode(hash);
+    return `uaid:aid:${id};uid=${input.uid};registry=${registry};proto=${protocol};nativeId=${input.nativeId}`;
+}
+//# sourceMappingURL=hcs14.js.map

package/dist/hcs14.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs14.js","sourceRoot":"","sources":["../src/hcs14.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiCzC,MAAM,eAAe,GAAG,4DAA4D,CAAC;AAErF,SAAS,YAAY,CAAC,KAAiB;IACrC,MAAM,MAAM,GAAa,CAAC,CAAC,CAAC,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,KAAK,IAAI,MAAM,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC;YAC1B,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACvB,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACxB,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,CAAC;YAAE,MAAM;QACtB,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,CACL,eAAe,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,YAAY,CAAC;QACxC,MAAM;aACH,OAAO,EAAE;aACT,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAE,CAAC;aACvC,IAAI,CAAC,EAAE,CAAC,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAsB;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,eAAe,CAAC;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,WAAW,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;IAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,QAAQ;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO;QACP,QAAQ;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;KAC3B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7D,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,YAAY,EAAE,QAAQ,KAAK,CAAC,GAAG,aAAa,QAAQ,UAAU,QAAQ,aAAa,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC7G,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./constants.js";
+export * from "./taxonomy.js";
+export * from "./pii.js";
+export * from "./tinybar.js";
+export * from "./schemas/assurance.js";
+export * from "./schemas/publisher.js";
+export * from "./schemas/intent.js";
+export * from "./schemas/campaign.js";
+export * from "./schemas/opportunity.js";
+export * from "./schemas/delivery.js";
+export * from "./schemas/reach.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from "./constants.js";
+export * from "./taxonomy.js";
+export * from "./pii.js";
+export * from "./tinybar.js";
+export * from "./schemas/assurance.js";
+export * from "./schemas/publisher.js";
+export * from "./schemas/intent.js";
+export * from "./schemas/campaign.js";
+export * from "./schemas/opportunity.js";
+export * from "./schemas/delivery.js";
+export * from "./schemas/reach.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/pii.d.ts

@@ -0,0 +1,2 @@
+export declare function containsObviousPii(text: string): boolean;
+//# sourceMappingURL=pii.d.ts.map

package/dist/pii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii.d.ts","sourceRoot":"","sources":["../src/pii.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/pii.js

@@ -0,0 +1,12 @@
+/**
+ * Minimal PII heuristics for sanitized semantic summaries (CLAUDE.md section 24).
+ * This is NOT a complete PII detection system - it only catches obvious
+ * email addresses and phone numbers so publishers don't accidentally leak
+ * raw private conversation into Hark.
+ */
+const EMAIL_PATTERN = /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/;
+const PHONE_PATTERN = /(\+?\d[\d\-.\s]{7,}\d)/;
+export function containsObviousPii(text) {
+    return EMAIL_PATTERN.test(text) || PHONE_PATTERN.test(text);
+}
+//# sourceMappingURL=pii.js.map

package/dist/pii.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii.js","sourceRoot":"","sources":["../src/pii.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,aAAa,GAAG,gDAAgD,CAAC;AACvE,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAE/C,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/dist/schemas/assurance.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/** Optional publisher-supplied assurance metadata (CLAUDE.md section 2.4). */
+export declare const assuranceSchema: z.ZodObject<{
+    type: z.ZodString;
+    provider: z.ZodString;
+    level: z.ZodOptional<z.ZodString>;
+    issuedAt: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    provider: string;
+    level?: string | undefined;
+    issuedAt?: string | undefined;
+    expiresAt?: string | undefined;
+}, {
+    type: string;
+    provider: string;
+    level?: string | undefined;
+    issuedAt?: string | undefined;
+    expiresAt?: string | undefined;
+}>;
+export type Assurance = z.infer<typeof assuranceSchema>;
+//# sourceMappingURL=assurance.d.ts.map

package/dist/schemas/assurance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assurance.d.ts","sourceRoot":"","sources":["../../src/schemas/assurance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas/assurance.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+/** Optional publisher-supplied assurance metadata (CLAUDE.md section 2.4). */
+export const assuranceSchema = z.object({
+    type: z.string().min(1),
+    provider: z.string().min(1),
+    level: z.string().optional(),
+    issuedAt: z.string().datetime().optional(),
+    expiresAt: z.string().datetime().optional(),
+});
+//# sourceMappingURL=assurance.js.map

package/dist/schemas/assurance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assurance.js","sourceRoot":"","sources":["../../src/schemas/assurance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/dist/schemas/campaign.d.ts

@@ -0,0 +1,177 @@
+import { z } from "zod";
+export declare const tinybarAmountSchema: z.ZodString;
+export declare const creativeSchema: z.ZodObject<{
+    headline: z.ZodString;
+    body: z.ZodString;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    ctaLabel: z.ZodString;
+    destinationUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    headline: string;
+    body: string;
+    ctaLabel: string;
+    destinationUrl: string;
+    imageUrl?: string | undefined;
+}, {
+    headline: string;
+    body: string;
+    ctaLabel: string;
+    destinationUrl: string;
+    imageUrl?: string | undefined;
+}>;
+export type Creative = z.infer<typeof creativeSchema>;
+/** Canonical Hark campaign object (CLAUDE.md section 9). */
+export declare const campaignSchema: z.ZodObject<{
+    id: z.ZodString;
+    advertiserAgentId: z.ZodString;
+    advertiserName: z.ZodString;
+    /** CLAUDE.md section 36 (HCS-14 bonus): optional, non-blocking agent identity metadata. */
+    advertiserHederaAccountId: z.ZodOptional<z.ZodString>;
+    advertiserHcs14Id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    productSummary: z.ZodString;
+    targetTopics: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    minRelevance: z.ZodNumber;
+    maxPriceTinybar: z.ZodString;
+    totalBudgetTinybar: z.ZodString;
+    creative: z.ZodObject<{
+        headline: z.ZodString;
+        body: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        ctaLabel: z.ZodString;
+        destinationUrl: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    }, {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    }>;
+    active: z.ZodBoolean;
+    startsAt: z.ZodOptional<z.ZodString>;
+    endsAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    active: boolean;
+    createdAt: string;
+    advertiserAgentId: string;
+    advertiserName: string;
+    productSummary: string;
+    targetTopics: string[];
+    minRelevance: number;
+    maxPriceTinybar: string;
+    totalBudgetTinybar: string;
+    creative: {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    };
+    advertiserHederaAccountId?: string | undefined;
+    advertiserHcs14Id?: string | undefined;
+    startsAt?: string | undefined;
+    endsAt?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    active: boolean;
+    createdAt: string;
+    advertiserAgentId: string;
+    advertiserName: string;
+    productSummary: string;
+    targetTopics: string[];
+    minRelevance: number;
+    maxPriceTinybar: string;
+    totalBudgetTinybar: string;
+    creative: {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    };
+    advertiserHederaAccountId?: string | undefined;
+    advertiserHcs14Id?: string | undefined;
+    startsAt?: string | undefined;
+    endsAt?: string | undefined;
+}>;
+export type Campaign = z.infer<typeof campaignSchema>;
+/** POST /v1/campaigns request body. */
+export declare const createCampaignInputSchema: z.ZodObject<{
+    advertiserAgentId: z.ZodString;
+    advertiserName: z.ZodString;
+    name: z.ZodString;
+    productSummary: z.ZodString;
+    targetTopics: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    minRelevance: z.ZodDefault<z.ZodNumber>;
+    maxPriceTinybar: z.ZodString;
+    totalBudgetTinybar: z.ZodString;
+    creative: z.ZodObject<{
+        headline: z.ZodString;
+        body: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        ctaLabel: z.ZodString;
+        destinationUrl: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    }, {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    }>;
+    startsAt: z.ZodOptional<z.ZodString>;
+    endsAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    advertiserAgentId: string;
+    advertiserName: string;
+    productSummary: string;
+    targetTopics: string[];
+    minRelevance: number;
+    maxPriceTinybar: string;
+    totalBudgetTinybar: string;
+    creative: {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    };
+    startsAt?: string | undefined;
+    endsAt?: string | undefined;
+}, {
+    name: string;
+    advertiserAgentId: string;
+    advertiserName: string;
+    productSummary: string;
+    targetTopics: string[];
+    maxPriceTinybar: string;
+    totalBudgetTinybar: string;
+    creative: {
+        headline: string;
+        body: string;
+        ctaLabel: string;
+        destinationUrl: string;
+        imageUrl?: string | undefined;
+    };
+    minRelevance?: number | undefined;
+    startsAt?: string | undefined;
+    endsAt?: string | undefined;
+}>;
+export type CreateCampaignInput = z.infer<typeof createCampaignInputSchema>;
+//# sourceMappingURL=campaign.d.ts.map

package/dist/schemas/campaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../src/schemas/campaign.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB,aAE4C,CAAC;AAE7E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,4DAA4D;AAC5D,eAAO,MAAM,cAAc;;;;IAIzB,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc3F,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,uCAAuC;AACvC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/campaign.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { isValidTopicId } from "../taxonomy.js";
+export const tinybarAmountSchema = z
+    .string()
+    .regex(/^\d+$/, "Amount must be a non-negative integer string of tinybar");
+export const creativeSchema = z.object({
+    headline: z.string().min(1),
+    body: z.string().min(1),
+    imageUrl: z.string().url().optional(),
+    ctaLabel: z.string().min(1),
+    destinationUrl: z.string().url(),
+});
+/** Canonical Hark campaign object (CLAUDE.md section 9). */
+export const campaignSchema = z.object({
+    id: z.string(),
+    advertiserAgentId: z.string(),
+    advertiserName: z.string(),
+    /** CLAUDE.md section 36 (HCS-14 bonus): optional, non-blocking agent identity metadata. */
+    advertiserHederaAccountId: z.string().optional(),
+    advertiserHcs14Id: z.string().optional(),
+    name: z.string(),
+    productSummary: z.string(),
+    targetTopics: z.array(z.string().refine(isValidTopicId, { message: "Unknown topic id" })).min(1),
+    minRelevance: z.number().min(0).max(1),
+    maxPriceTinybar: tinybarAmountSchema,
+    totalBudgetTinybar: tinybarAmountSchema,
+    creative: creativeSchema,
+    active: z.boolean(),
+    startsAt: z.string().datetime().optional(),
+    endsAt: z.string().datetime().optional(),
+    createdAt: z.string().datetime(),
+});
+/** POST /v1/campaigns request body. */
+export const createCampaignInputSchema = z.object({
+    advertiserAgentId: z.string().min(1),
+    advertiserName: z.string().min(1),
+    name: z.string().min(1),
+    productSummary: z.string().min(1),
+    targetTopics: z.array(z.string().refine(isValidTopicId, { message: "Unknown topic id" })).min(1),
+    minRelevance: z.number().min(0).max(1).default(0.7),
+    maxPriceTinybar: tinybarAmountSchema,
+    totalBudgetTinybar: tinybarAmountSchema,
+    creative: creativeSchema,
+    startsAt: z.string().datetime().optional(),
+    endsAt: z.string().datetime().optional(),
+});
+//# sourceMappingURL=campaign.js.map

package/dist/schemas/campaign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../src/schemas/campaign.ts"],"names":[],"mappings":"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"}