@tickernelz/paperclip-pro-shared 2026.1011.3 → 2026.1012.1

package/dist/.paperclip-build-complete

@@ -1 +1 @@
-{"sources":"00d7f57878660b2b10ffe61fff2eb0a9e633bab80024895fb12b4391683f9700","outputs":"fc11d89b433dffbdf7748cd6d64c8747ac4513991a5f0c098af97f594fc05095"}
+{"sources":"0746f045d706d081f63dd832942fcac54fb094341727550b1d6c0d5b2c6ab0a1","outputs":"16becfba49b1bf759e1395710d800c592786a05f8c64c71253d7bf882905100a"}

package/dist/accounting.d.ts

@@ -0,0 +1,178 @@
+import { z } from "zod";
+export declare const exactCentsSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+export declare const pricingProvenanceSchema: z.ZodObject<{
+    source: z.ZodDefault<z.ZodEnum<{
+        operator: "operator";
+        provider_invoice: "provider_invoice";
+        provider_reported: "provider_reported";
+        rate_card: "rate_card";
+        unknown: "unknown";
+    }>>;
+    version: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodString>;
+    inputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+    cachedInputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+    outputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+    cacheWriteCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+    serviceTier: z.ZodOptional<z.ZodString>;
+    contextTier: z.ZodOptional<z.ZodEnum<{
+        long: "long";
+        short: "short";
+    }>>;
+}, z.core.$strip>;
+export declare const importBillingInvoiceSchema: z.ZodObject<{
+    biller: z.ZodString;
+    externalId: z.ZodString;
+    currency: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    lines: z.ZodArray<z.ZodObject<{
+        externalId: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            credit: "credit";
+            fee: "fee";
+            inference: "inference";
+        }>>;
+        amountCents: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        occurredAt: z.ZodISODateTime;
+        costEventId: z.ZodOptional<z.ZodString>;
+        runId: z.ZodOptional<z.ZodString>;
+        providerRequestId: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        pricing: z.ZodOptional<z.ZodObject<{
+            source: z.ZodDefault<z.ZodEnum<{
+                operator: "operator";
+                provider_invoice: "provider_invoice";
+                provider_reported: "provider_reported";
+                rate_card: "rate_card";
+                unknown: "unknown";
+            }>>;
+            version: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodOptional<z.ZodString>;
+            inputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+            cachedInputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+            outputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+            cacheWriteCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+            serviceTier: z.ZodOptional<z.ZodString>;
+            contextTier: z.ZodOptional<z.ZodEnum<{
+                long: "long";
+                short: "short";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const adjustCostSchema: z.ZodObject<{
+    idempotencyKey: z.ZodString;
+    expectedCents: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    correctedCents: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    invoiceLineId: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+    pricing: z.ZodObject<{
+        source: z.ZodDefault<z.ZodEnum<{
+            operator: "operator";
+            provider_invoice: "provider_invoice";
+            provider_reported: "provider_reported";
+            rate_card: "rate_card";
+            unknown: "unknown";
+        }>>;
+        version: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        inputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+        cachedInputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+        outputCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+        cacheWriteCentsPerMillion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+        serviceTier: z.ZodOptional<z.ZodString>;
+        contextTier: z.ZodOptional<z.ZodEnum<{
+            long: "long";
+            short: "short";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const repairAccountingSchema: z.ZodObject<{
+    fingerprint: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const retryAccountingSchema: z.ZodObject<{
+    runId: z.ZodString;
+}, z.core.$strip>;
+export declare const importProviderCostsSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        anthropic: "anthropic";
+        openai: "openai";
+    }>;
+    secretId: z.ZodString;
+    accountId: z.ZodString;
+    scopeIds: z.ZodArray<z.ZodString>;
+    from: z.ZodISODate;
+    to: z.ZodISODate;
+}, z.core.$strip>;
+export type ImportProviderCosts = z.input<typeof importProviderCostsSchema>;
+export type ImportBillingInvoice = z.input<typeof importBillingInvoiceSchema>;
+export type AdjustCost = z.input<typeof adjustCostSchema>;
+export interface AccountingFinding {
+    kind: "company_projection" | "agent_projection" | "runtime_projection" | "missing_receipt" | "missing_acknowledgement" | "legacy_runtime" | "receipt_mismatch";
+    entityId: string;
+    repairable: boolean;
+    actual: Record<string, string>;
+    expected: Record<string, string>;
+}
+export interface AccountingInspection {
+    companyId: string;
+    fingerprint: string;
+    findings: AccountingFinding[];
+    checkedAt: string;
+}
+export interface AccountingHealth {
+    companyId: string;
+    pendingRunCount: number;
+    unpricedEventCount: number;
+    oldestPendingAt: string | null;
+    pendingCancellationCount: number;
+    heldReservationCents: string;
+    items: Array<{
+        runId: string | null;
+        costEventId?: string;
+        agentId: string | null;
+        state: "waiting_for_receipt" | "retryable" | "unpriced";
+        lastError: string | null;
+        attempts: number;
+        since: string;
+        lastAttemptAt: string | null;
+    }>;
+}
+export interface BillingInvoice {
+    id: string;
+    companyId: string;
+    biller: string;
+    externalId: string;
+    currency: string;
+    createdAt: string;
+}
+export interface CostAdjustment {
+    id: string;
+    companyId: string;
+    costEventId: string;
+    invoiceLineId: string | null;
+    idempotencyKey: string;
+    receiptHash: string;
+    previousCents: string;
+    correctedCents: string;
+    previousStatus: string;
+    previousPricing: Record<string, unknown>;
+    pricing: Record<string, unknown>;
+    reason: string;
+    actorId: string;
+    createdAt: string;
+}
+export interface BillingReconciliation {
+    invoice: BillingInvoice;
+    lines: Array<{
+        id: string;
+        externalId: string;
+        kind: string;
+        amountCents: string;
+        status: string;
+        matchedEventId: string | null;
+        recordedCents: string | null;
+        differenceCents: string | null;
+    }>;
+}
+//# sourceMappingURL=accounting.d.ts.map

package/dist/accounting.d.ts.map

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

package/dist/accounting.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { centsToUnits, normalizeCents } from "./money.js";
+export const exactCentsSchema = z.union([z.string().max(160), z.number().finite()]).transform((value, ctx) => {
+    try {
+        if ((typeof value === "number" ? value < 0 : value.startsWith("-")) || centsToUnits(value) < 0n)
+            throw new Error("Money cannot be negative");
+        return normalizeCents(value);
+    }
+    catch (error) {
+        ctx.addIssue({ code: "custom", message: error instanceof Error ? error.message : "Invalid money" });
+        return z.NEVER;
+    }
+});
+export const pricingProvenanceSchema = z.object({
+    source: z.enum(["provider_reported", "provider_invoice", "operator", "rate_card", "unknown"]).default("unknown"),
+    version: z.string().max(100).optional(),
+    evidence: z.string().max(1000).optional(),
+    inputCentsPerMillion: exactCentsSchema.optional(),
+    cachedInputCentsPerMillion: exactCentsSchema.optional(),
+    outputCentsPerMillion: exactCentsSchema.optional(),
+    cacheWriteCentsPerMillion: exactCentsSchema.optional(),
+    serviceTier: z.string().max(50).optional(),
+    contextTier: z.enum(["short", "long"]).optional(),
+});
+export const importBillingInvoiceSchema = z.object({
+    biller: z.string().trim().min(1).max(150),
+    externalId: z.string().trim().min(1).max(200),
+    currency: z.string().regex(/^[A-Za-z]{3}$/).transform(value => value.toUpperCase()),
+    lines: z.array(z.object({
+        externalId: z.string().trim().min(1).max(200),
+        kind: z.enum(["inference", "fee", "credit"]).default("inference"),
+        amountCents: exactCentsSchema,
+        occurredAt: z.iso.datetime({ offset: true }),
+        costEventId: z.string().uuid().optional(),
+        runId: z.string().uuid().optional(),
+        providerRequestId: z.string().min(1).max(250).optional(),
+        model: z.string().min(1).max(250).optional(),
+        pricing: pricingProvenanceSchema.optional(),
+    })).min(1).max(2000),
+}).superRefine((invoice, ctx) => {
+    if (new Set(invoice.lines.map(line => line.externalId)).size !== invoice.lines.length)
+        ctx.addIssue({ code: "custom", path: ["lines"], message: "Invoice line identifiers must be unique" });
+});
+export const adjustCostSchema = z.object({
+    idempotencyKey: z.string().trim().min(1).max(200),
+    expectedCents: exactCentsSchema,
+    correctedCents: exactCentsSchema,
+    invoiceLineId: z.string().uuid().optional(),
+    reason: z.string().trim().min(1).max(1000),
+    pricing: pricingProvenanceSchema,
+});
+export const repairAccountingSchema = z.object({ fingerprint: z.string().regex(/^[a-f0-9]{64}$/), reason: z.string().trim().min(1).max(1000) });
+export const retryAccountingSchema = z.object({ runId: z.string().uuid() });
+export const importProviderCostsSchema = z.object({
+    provider: z.enum(["openai", "anthropic"]),
+    secretId: z.string().uuid(),
+    accountId: z.string().trim().min(1).max(150).regex(/^[a-zA-Z0-9_-]+$/),
+    scopeIds: z.array(z.string().trim().min(1).max(150)).min(1).max(25),
+    from: z.iso.date(),
+    to: z.iso.date(),
+}).superRefine((input, ctx) => {
+    const duration = Date.parse(input.to) - Date.parse(input.from);
+    if (duration <= 0 || duration > 31 * 86400000 || Date.parse(input.to) > Math.floor(Date.now() / 86400000) * 86400000)
+        ctx.addIssue({ code: "custom", message: "Choose up to 31 completed UTC days; the end date is exclusive." });
+    if (new Set(input.scopeIds).size !== input.scopeIds.length)
+        ctx.addIssue({ code: "custom", message: "Project/workspace identifiers must be unique." });
+});
+//# sourceMappingURL=accounting.js.map

package/dist/accounting.js.map

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

package/dist/agent-appearance.d.ts

@@ -4,6 +4,9 @@ export type AgentPaletteId = typeof AGENT_PALETTE_IDS[number];
 export type CharacterPaletteId = AgentPaletteId | "muted-dream";
 export declare const AGENT_AVATAR_SIZES: readonly [16, 20, 24, 32, 40, 48, 64, 96, 128, 256, 512];
 export type AgentAvatarSize = typeof AGENT_AVATAR_SIZES[number];
+export type AgentAvatarBackground = "transparent" | "paperclip-dark";
+/** sRGB PNG equivalent of index.css .dark --background: oklch(0.205 0 0). */
+export declare const PAPERCLIP_DARK_AVATAR_BACKGROUND = "#171717";
 export declare const CHARACTER_STATES: readonly ["rest", "idle", "listening", "thinking", "working", "success", "confused", "sleepy", "loading"];
 export type CharacterState = typeof CHARACTER_STATES[number];
 export declare const agentAppearanceSchema: z.ZodObject<{
@@ -28,6 +31,7 @@ export declare const agentAppearanceSchema: z.ZodObject<{
         "ultraviolet-tide": "ultraviolet-tide";
         "violet-ember": "violet-ember";
     }>;
+    customAvatarAssetId: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strict>;
 export type AgentAppearance = z.infer<typeof agentAppearanceSchema>;
 export declare function appearanceForPalette(paletteId: AgentPaletteId): AgentAppearance;
@@ -36,7 +40,7 @@ export declare function randomAgentAppearance(): AgentAppearance;
 /** Must match the migration: rolling base-31 hash, modulo 17 at every step. */
 export declare function legacyAgentAppearance(id: string): AgentAppearance;
 export declare function resolveAgentAppearance(appearance: unknown, id?: string): AgentAppearance;
-export declare function agentAvatarUrl(appearance: AgentAppearance, size?: AgentAvatarSize, scale?: 1 | 2, pose?: CharacterState, muted?: boolean): string;
+export declare function agentAvatarUrl(appearance: AgentAppearance, size?: AgentAvatarSize, scale?: 1 | 2, pose?: CharacterState, muted?: boolean, background?: AgentAvatarBackground): string;
 export declare function characterStateForAgent(status: string): CharacterState;
 /** Hydrate compact agent projections without an additional per-agent request. */
 export declare function withAgentAppearance<T extends {
@@ -47,6 +51,7 @@ export declare function withAgentAppearance<T extends {
         schemaVersion: 1;
         characterVersion: "cap-v1";
         paletteId: "arctic-blue" | "bubblegum-sky" | "cherry-pop" | "coral-current" | "coral-mint" | "deep-tide" | "electric-grove" | "flamingo-jade" | "golden-hour" | "lime-lagoon" | "orchid-peach" | "pink-lemonade" | "solar-flare" | "tangerine-cobalt" | "turquoise-cherry" | "ultraviolet-tide" | "violet-ember";
+        customAvatarAssetId?: string | undefined;
     };
     avatarUrl: string;
 };

package/dist/agent-appearance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-appearance.d.ts","sourceRoot":"","sources":["../src/agent-appearance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB,YAAI,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,CAAU,CAAC;AAClU,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,aAAa,CAAC;AAChE,eAAO,MAAM,kBAAkB,YAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAC3F,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAChE,eAAO,MAAM,gBAAgB,YAAI,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAC1I,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;kBAIvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,cAAc,GAAG,eAAe,CAE/E;AACD,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,eAAe,CAMvD;AACD,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAIjE;AACD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,SAAU,GAAG,eAAe,CAGzF;AACD,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,GAAE,eAAqB,EAAE,KAAK,GAAE,CAAC,GAAG,CAAK,EAAE,IAAI,GAAE,cAAuB,EAAE,KAAK,UAAQ,GAAG,MAAM,CAE/J;AACD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAKrE;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC;;;;;;;EAG1G"}
+{"version":3,"file":"agent-appearance.d.ts","sourceRoot":"","sources":["../src/agent-appearance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB,YAAI,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,CAAU,CAAC;AAClU,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,aAAa,CAAC;AAChE,eAAO,MAAM,kBAAkB,YAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAC3F,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,gBAAgB,CAAC;AACrE,6EAA6E;AAC7E,eAAO,MAAM,gCAAgC,YAAY,CAAC;AAC1D,eAAO,MAAM,gBAAgB,YAAI,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAC1I,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;kBAMvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,cAAc,GAAG,eAAe,CAE/E;AACD,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,eAAe,CAMvD;AACD,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAIjE;AACD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,SAAU,GAAG,eAAe,CAGzF;AACD,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,GAAE,eAAqB,EAAE,KAAK,GAAE,CAAC,GAAG,CAAK,EAAE,IAAI,GAAE,cAAuB,EAAE,KAAK,UAAQ,EAAE,UAAU,GAAE,qBAAqC,GAAG,MAAM,CAGlN;AACD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAKrE;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC;;;;;;;;EAG1G"}

package/dist/agent-appearance.js

@@ -1,11 +1,15 @@
 import { z } from "zod";
 export const AGENT_PALETTE_IDS = ["bubblegum-sky", "pink-lemonade", "orchid-peach", "coral-mint", "lime-lagoon", "arctic-blue", "solar-flare", "violet-ember", "deep-tide", "coral-current", "golden-hour", "tangerine-cobalt", "electric-grove", "flamingo-jade", "cherry-pop", "turquoise-cherry", "ultraviolet-tide"];
 export const AGENT_AVATAR_SIZES = [16, 20, 24, 32, 40, 48, 64, 96, 128, 256, 512];
+/** sRGB PNG equivalent of index.css .dark --background: oklch(0.205 0 0). */
+export const PAPERCLIP_DARK_AVATAR_BACKGROUND = "#171717";
 export const CHARACTER_STATES = ["rest", "idle", "listening", "thinking", "working", "success", "confused", "sleepy", "loading"];
 export const agentAppearanceSchema = z.object({
     schemaVersion: z.literal(1),
     characterVersion: z.literal("cap-v1"),
     paletteId: z.enum(AGENT_PALETTE_IDS),
+    /** Company-scoped normalized image, set through the avatar upload service. */
+    customAvatarAssetId: z.uuid().optional(),
 }).strict();
 export function appearanceForPalette(paletteId) {
     return { schemaVersion: 1, characterVersion: "cap-v1", paletteId };
@@ -31,8 +35,10 @@ export function resolveAgentAppearance(appearance, id = "agent") {
     const parsed = agentAppearanceSchema.safeParse(appearance);
     return parsed.success ? parsed.data : legacyAgentAppearance(id);
 }
-export function agentAvatarUrl(appearance, size = 512, scale = 1, pose = "rest", muted = false) {
-    return `/api/agent-avatars/${appearance.characterVersion}/${muted ? "muted-dream" : appearance.paletteId}/${pose}.png?size=${size}&scale=${scale}`;
+export function agentAvatarUrl(appearance, size = 512, scale = 1, pose = "rest", muted = false, background = "transparent") {
+    if (appearance.customAvatarAssetId)
+        return `/api/assets/${appearance.customAvatarAssetId}/content`;
+    return `/api/agent-avatars/${appearance.characterVersion}/${muted ? "muted-dream" : appearance.paletteId}/${pose}.png?size=${size}&scale=${scale}${background === "paperclip-dark" ? "&background=paperclip-dark" : ""}`;
 }
 export function characterStateForAgent(status) {
     if (status === "running")

package/dist/agent-appearance.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-appearance.js","sourceRoot":"","sources":["../src/agent-appearance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-appearance.js","sourceRoot":"","sources":["../src/agent-appearance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,CAAU,CAAC;AAGlU,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAG3F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gCAAgC,GAAG,SAAS,CAAC;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAE1I,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACpC,8EAA8E;IAC9E,mBAAmB,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,UAAU,oBAAoB,CAAC,SAAyB;IAC5D,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC;AACD,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IACjC,yCAAyC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC5F,GAAG,CAAC;QAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE;IAC3E,OAAO,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;AACtF,CAAC;AACD,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,EAAU;IAC9C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,EAAE;QAAE,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC1F,OAAO,oBAAoB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC;AACD,MAAM,UAAU,sBAAsB,CAAC,UAAmB,EAAE,EAAE,GAAG,OAAO;IACtE,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;AAClE,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,UAA2B,EAAE,IAAI,GAAoB,GAAG,EAAE,KAAK,GAAU,CAAC,EAAE,IAAI,GAAmB,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,UAAU,GAA0B,aAAa;IACxM,IAAI,UAAU,CAAC,mBAAmB;QAAE,OAAO,eAAe,UAAU,CAAC,mBAAmB,UAAU,CAAC;IACnG,OAAO,sBAAsB,UAAU,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,IAAI,aAAa,IAAI,UAAU,KAAK,GAAG,UAAU,KAAK,gBAAgB,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC3N,CAAC;AACD,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC;IAC1C,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,kBAAkB;QAAE,OAAO,MAAM,CAAC;IACnG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CAAgE,KAAQ;IACzG,MAAM,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;AACzE,CAAC"}

package/dist/agent-appearance.test.js

@@ -14,6 +14,12 @@ describe("agent appearance", () => {
         expect(legacyAgentAppearance("agent-1")).toEqual(legacyAgentAppearance("agent-1"));
         expect(agentAvatarUrl(appearance, 24, 2)).toBe("/api/agent-avatars/cap-v1/deep-tide/rest.png?size=24&scale=2");
     });
+    it("uses a private asset URL for custom avatars while retaining the fallback palette", () => {
+        const appearance = { ...appearanceForPalette("deep-tide"), customAvatarAssetId: "22222222-2222-4222-8222-222222222222" };
+        expect(resolveAgentAppearance(appearance)).toEqual(appearance);
+        expect(agentAvatarUrl(appearance, 128, 2)).toBe("/api/assets/22222222-2222-4222-8222-222222222222/content");
+        expect(agentAppearanceSchema.safeParse({ ...appearance, customAvatarAssetId: "https://example.test/image" }).success).toBe(false);
+    });
     it("renders without a browser and preserves logical-size detail at high density", () => {
         const appearance = appearanceForPalette("bubblegum-sky");
         // ClipLab v0.2.0 draws an enlarged compact face from 16px; only 12px and
@@ -28,5 +34,10 @@ describe("agent appearance", () => {
         expect(renderAgentSvg(appearance, 48, 1)).toContain('id="agent-candle-light"');
         expect(renderAgentSvg(appearance, 24, 2)).toBe(eyes);
     });
+    it("uses a separate URL for opaque Slack exports without changing ordinary portraits", () => {
+        const appearance = appearanceForPalette("cherry-pop");
+        expect(agentAvatarUrl(appearance, 512, 1, "rest", false, "paperclip-dark")).toBe("/api/agent-avatars/cap-v1/cherry-pop/rest.png?size=512&scale=1&background=paperclip-dark");
+        expect(agentAvatarUrl(appearance)).not.toContain("background=");
+    });
 });
 //# sourceMappingURL=agent-appearance.test.js.map

package/dist/agent-appearance.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-appearance.test.js","sourceRoot":"","sources":["../src/agent-appearance.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7L,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;YAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC,SAAS,CAAC,CAAC;QACrG,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1I,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,UAAU,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,CAAC,sBAAsB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/E,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1F,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,UAAU,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;QACzD,yEAAyE;QACzE,2CAA2C;QAC3C,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC/E,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"agent-appearance.test.js","sourceRoot":"","sources":["../src/agent-appearance.test.ts"],"names":[],"mappings":"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"}

package/dist/agent-avatar-upload.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const MAX_AGENT_AVATAR_BYTES: number;
+/** Raw PNG/JPEG/WebP bytes, not a URL or a data URL. Null restores the Paperclip character. */
+export declare const setAgentAvatarSchema: z.ZodObject<{
+    imageBase64: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type SetAgentAvatarInput = z.infer<typeof setAgentAvatarSchema>;
+//# sourceMappingURL=agent-avatar-upload.d.ts.map

package/dist/agent-avatar-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-avatar-upload.d.ts","sourceRoot":"","sources":["../src/agent-avatar-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB,QAAa,CAAC;AACjD,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB;;kBAItB,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/agent-avatar-upload.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export const MAX_AGENT_AVATAR_BYTES = 512 * 1024;
+/** Raw PNG/JPEG/WebP bytes, not a URL or a data URL. Null restores the Paperclip character. */
+export const setAgentAvatarSchema = z.object({
+    imageBase64: z.string().min(4).max(4 * Math.ceil(MAX_AGENT_AVATAR_BYTES / 3))
+        .regex(/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/)
+        .nullable(),
+}).strict();
+//# sourceMappingURL=agent-avatar-upload.js.map

package/dist/agent-avatar-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-avatar-upload.js","sourceRoot":"","sources":["../src/agent-avatar-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,GAAG,IAAI,CAAC;AACjD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC;SAC1E,KAAK,CAAC,kEAAkE,CAAC;SACzE,QAAQ,EAAE;CACd,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/agent-commentary.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-commentary.test.d.ts.map

package/dist/agent-commentary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-commentary.test.d.ts","sourceRoot":"","sources":["../src/agent-commentary.test.ts"],"names":[],"mappings":""}

package/dist/agent-commentary.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { AGENT_COMMENTARY_MAX_LENGTH, submitAgentCommentarySchema } from "./validators/agent-commentary.js";
+describe("agent commentary input", () => {
+    const input = { kind: "complaint", body: "WHY 😭\n\nThis tool again.", idempotencyKey: "one" };
+    it("preserves free-form text and the document-sized ceiling", () => {
+        expect(submitAgentCommentarySchema.parse(input)).toEqual(input);
+        const body = "🙂".repeat(AGENT_COMMENTARY_MAX_LENGTH / 2);
+        expect(submitAgentCommentarySchema.parse({ ...input, kind: "suggestion", body }).body).toBe(body);
+        expect(submitAgentCommentarySchema.safeParse({ ...input, body: body + "x" }).success).toBe(false);
+    });
+    it.each([
+        { body: " \n\t" }, { kind: "other" }, { idempotencyKey: "" }, { idempotencyKey: "x".repeat(241) },
+        { agentId: "spoof" }, { companyId: "spoof" }, { runId: "spoof" }, { issueId: "spoof" }, { category: "tooling" },
+    ])("rejects invalid or caller-owned fields: %j", (change) => {
+        expect(submitAgentCommentarySchema.safeParse({ ...input, ...change }).success).toBe(false);
+    });
+});
+//# sourceMappingURL=agent-commentary.test.js.map

package/dist/agent-commentary.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-commentary.test.js","sourceRoot":"","sources":["../src/agent-commentary.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE5G,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,4BAA4B,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC/F,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,2BAA2B,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClG,MAAM,CAAC,2BAA2B,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,IAAI,CAAC;QACN,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QACjG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;KAChH,CAAC,CAAC,4CAA4C,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1D,MAAM,CAAC,2BAA2B,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}