@agent-native/creative-context 0.0.0-beta-20260820202238

package/README.md

@@ -0,0 +1,154 @@
+# @agent-native/creative-context
+
+Shared creative-library ingestion, governed reusable contexts, immutable
+evidence, hybrid retrieval, brand context, and generation provenance for Agent
+Native creative apps.
+
+Creative Context is a Toolkit capability module installed on demand. It lives
+in its own npm package so apps only take the governed corpus, retrieval, UI, and
+lifecycle metadata they need.
+
+The package turns Google Slides, Figma, Notion, websites, and uploaded
+PPTX/DOCX/PDF/PNG/JPEG/WebP/GIF/safe-SVG files into a versioned SQL corpus. Binary originals, localized visual
+fallbacks, and bounded UI thumbnails live in private blob storage; full-slide
+and full-frame source renders are temporary QA inputs and are discarded. Text remains directly greppable in
+SQL; PostgreSQL deployments add full-text candidates and pgvector visual
+similarity in the same `DATABASE_URL` database.
+
+## Install
+
+```bash
+pnpm add @agent-native/creative-context
+```
+
+Add the server plugin once per app:
+
+```ts
+// server/plugins/creative-context.ts
+import { setupCreativeContext } from "@agent-native/creative-context/server";
+
+export default setupCreativeContext({ appId: "slides" });
+```
+
+Mount the shared Library tab on the app's existing Agent page:
+
+```tsx
+import { AgentTabsPage } from "@agent-native/core/client";
+import { createCreativeContextAgentTab } from "@agent-native/creative-context/client";
+
+export default function AgentPage() {
+  return <AgentTabsPage extraTabFactories={[createCreativeContextAgentTab]} />;
+}
+```
+
+Importing `./server` registers the package actions through the framework's
+package-action registry, applies additive corpus migrations, registers
+shareable sources/profiles/contexts/packs, starts resumable import processing,
+and conditionally contributes published brand context to agent prompts. Each
+owning app also registers a server-side native capture adapter so its Share
+popover can submit a deck, design, document, asset, or dashboard by resource id
+without sending native payloads through a generic action. The prompt
+contribution is omitted structurally whenever application state contains
+`{ contextMode: "off" }`.
+
+## Governed contexts
+
+A brand profile contains approved identity and DNA. A Creative Context is the
+durable, shareable collection people maintain (for example Default, Marketing,
+Product, or Sales). A context pack is the immutable exact-version receipt for
+one generation.
+
+- Every personal or organization scope has one non-archivable Default context.
+- Requests use Default plus at most one specialty context. Explicit selection
+  wins; an app binding or semantic match supplies the automatic specialty.
+- `open` contexts publish editor submissions immediately. `review` and
+  `admins-only` contexts keep the proposed version private to its submitter and
+  context administrators until approval.
+- The currently approved snapshot remains active while a newer version is
+  pending. Removal affects new retrieval immediately without rewriting old
+  packs.
+- Publishing into a broader context requires source-management permission and
+  explicit confirmation. Acceptance writes an immutable context-owned copy;
+  it never changes the original resource's sharing.
+
+The standard UI is the Context tab in the framework Share popover plus the
+context-first Library. The Library rail selects Default or a specialty and its
+Items, Sources, Approvals, and Settings views show only safe, bounded previews:
+slide filmstrips, design frames, rendered document structure, access-scoped
+media, and dashboards populated with synthetic preview data.
+
+Exact app-native data is a separate private blob capability. Generic list,
+item, pack, status, media, and search responses never expose that capability.
+Only the owning app's typed clone action can resolve it, verify the stored hash
+and resource identity, and create a new editable resource through that app's
+normal persistence path. Imported Google Slides and Figma artifacts continue
+to use the stricter trusted-compiler and native-reassembly path.
+
+## Retrieval behavior
+
+- Portable SQL uses normalized grep modes (`allTerms`, `anyTerm`, `phrase`,
+  `regex`) and weighted title/summary/body scoring.
+- PostgreSQL adds a `tsvector`/GIN candidate lane and one configured multimodal
+  embedding family backed by pgvector in the same database.
+- SQLite keeps corpus and lexical/caption search only. Visual queries fail with
+  a clear PostgreSQL+pgvector requirement; the package never creates another
+  SQLite or vector database.
+- Every context-backed generation resolves Default plus zero or one specialty,
+  applies the specialty ranking boost, and snapshots exact
+  `(itemId, itemVersionId)` evidence, lane scores, selection reason, and context
+  ids into an immutable context pack.
+
+Context packs are intentionally ownable and independently shareable instead of
+inheriting broad source visibility. A pack records one generation's request,
+selected evidence, and influence scores, which can reveal private work intent
+even when every underlying source is organization-visible. Only the creator can
+see a new pack; collaborators receive it through an explicit pack share.
+Ordinary source evidence remains subject to current source access and
+revocation. Context-owned published snapshots remain replayable at their pinned
+version for authorized pack viewers after membership removal.
+
+## Isolated deployments
+
+Apps in one workspace use the shared database in-process by default. If an app
+is deployed against a separate database, set `CREATIVE_CONTEXT_A2A_URL` to the
+app that owns the corpus and configure either the shared `A2A_SECRET` on both
+deployments or a matching org-scoped `CREATIVE_CONTEXT_A2A_KEY`. The fallback
+forwards only bounded resolve, validate, generation-record read, and
+generation-record write operations through the authenticated A2A protocol.
+Caller identity is signed and re-resolved by the receiver, all request and
+response shapes are strictly validated, and malformed or timed-out responses
+fail clearly instead of falling back to untracked context. Optional
+`CREATIVE_CONTEXT_A2A_TIMEOUT_MS` is clamped to 1–60 seconds and defaults to 30
+seconds. Do not place these values in client code or application state.
+
+`CREATIVE_CONTEXT_A2A_URL` is opt-in: without it, no A2A request occurs. A
+saved or one-generation `contextMode: "off"` also structurally suppresses the
+remote path.
+
+## Trust and lifecycle
+
+Imported text is evidence, never instructions. Only human-published, validated
+structured brand fields can enter the typed `<brand-context>` prompt block.
+Restricted upstream items default to review and exclusion. Organization copies
+require an organization admin or verified container owner plus a confirmation
+of the exact container and item count. Disconnecting or deleting a source
+tombstones it synchronously so retrieval stops immediately; private blobs are
+purged asynchronously. Native context submissions use the same fail-closed
+private-blob rule and never fall back to SQL payload storage.
+
+## Exports
+
+| Subpath        | Purpose                                                      |
+| -------------- | ------------------------------------------------------------ |
+| `.`            | Shared types and generation-context helpers                  |
+| `./actions`    | Registered action map                                        |
+| `./client`     | Library panel, Agent tab, context chip, state hooks          |
+| `./connectors` | Connector registry plus public Slides/Figma native compilers |
+| `./embeddings` | Multimodal family adapters and bake-off inputs               |
+| `./eval`       | Retrieval, quality, and hard-gate evaluation helpers         |
+| `./jobs`       | Durable import, enrichment, purge, and rebuild workers       |
+| `./messages`   | Shared localized Library UI messages                         |
+| `./schema`     | Additive Drizzle corpus schema and migrations                |
+| `./server`     | Setup plugin, action registration, prompt/resource wiring    |
+| `./store`      | Access-scoped corpus stores                                  |
+| `./vector`     | PostgreSQL/pgvector adapter and fail-clear guard             |

package/agent-native.eject.json

@@ -0,0 +1,41 @@
+{
+  "manifestVersion": 1,
+  "package": "@agent-native/creative-context",
+  "catalogs": ["domain-packages"],
+  "units": [
+    {
+      "id": "package/creative-context",
+      "label": "Creative Context domain package",
+      "catalog": "domain-packages",
+      "catalogItems": ["creative-context"],
+      "entrypoints": [
+        ".",
+        "./actions",
+        "./client",
+        "./connectors",
+        "./messages",
+        "./jobs",
+        "./embeddings",
+        "./eval",
+        "./schema",
+        "./search/fusion",
+        "./server",
+        "./store",
+        "./types",
+        "./vector"
+      ],
+      "strategy": "package-eject",
+      "sourceEntries": [
+        "src",
+        "docs",
+        "agent-native.eject.json",
+        "agent-native.package.json",
+        "package.json",
+        "tsconfig.json"
+      ],
+      "targetRoot": "packages/creative-context",
+      "protectedImports": ["@agent-native/core"],
+      "verification": ["pnpm --dir packages/creative-context typecheck"]
+    }
+  ]
+}

package/agent-native.package.json

@@ -0,0 +1,119 @@
+{
+  "manifestVersion": 1,
+  "name": "@agent-native/creative-context",
+  "actions": [
+    "confirm-canonical-logo",
+    "continue-context-import",
+    "creative-context-a2a",
+    "get-brand-profile",
+    "get-context-import-status",
+    "get-context-item",
+    "get-context-pack",
+    "get-google-picker-session",
+    "infer-brand-dna",
+    "list-canonical-logo-candidates",
+    "list-context-connections",
+    "list-context-memberships",
+    "list-context-packs",
+    "list-context-sources",
+    "list-context-suggestions",
+    "list-creative-contexts",
+    "manage-brand-profile",
+    "manage-context-pack",
+    "manage-context-membership",
+    "manage-context-source",
+    "manage-creative-context",
+    "manage-layout-template",
+    "preview-context-import",
+    "process-context-purge",
+    "propose-brand-dna",
+    "propose-canonical-logo",
+    "publish-brand-dna",
+    "recommend-context-roots",
+    "record-context-feedback",
+    "review-context-items",
+    "run-embedding-bakeoff",
+    "search-creative-context",
+    "set-brand-dna",
+    "start-context-import",
+    "start-context-enrichment"
+  ],
+  "schemaEntryPoint": "@agent-native/creative-context/schema",
+  "docs": {
+    "llms": "docs/llms.txt",
+    "llmsFull": "docs/llms-full.txt",
+    "skills": ["creative-context"]
+  },
+  "requiredSecrets": [
+    {
+      "key": "CREATIVE_CONTEXT_A2A_KEY",
+      "label": "Isolated Creative Context A2A signing key",
+      "optional": true
+    },
+    {
+      "key": "GOOGLE_CLIENT_ID",
+      "label": "Google OAuth client ID for Drive and Slides",
+      "optional": true
+    },
+    {
+      "key": "GOOGLE_CLIENT_SECRET",
+      "label": "Google OAuth client secret for Drive and Slides",
+      "optional": true
+    },
+    {
+      "key": "GOOGLE_PICKER_API_KEY",
+      "label": "Browser-restricted Google Picker API key",
+      "optional": true
+    },
+    {
+      "key": "GOOGLE_PICKER_APP_ID",
+      "label": "Google Cloud project number for Picker",
+      "optional": true
+    },
+    {
+      "key": "FIGMA_CLIENT_ID",
+      "label": "Figma OAuth client ID",
+      "optional": true
+    },
+    {
+      "key": "FIGMA_CLIENT_SECRET",
+      "label": "Figma OAuth client secret",
+      "optional": true
+    },
+    {
+      "key": "FIGMA_ACCESS_TOKEN",
+      "label": "Figma personal access token fallback",
+      "optional": true
+    },
+    {
+      "key": "NOTION_CLIENT_ID",
+      "label": "Notion OAuth client ID",
+      "optional": true
+    },
+    {
+      "key": "NOTION_CLIENT_SECRET",
+      "label": "Notion OAuth client secret",
+      "optional": true
+    },
+    {
+      "key": "GEMINI_API_KEY",
+      "label": "Gemini multimodal embedding key",
+      "optional": true
+    },
+    {
+      "key": "COHERE_API_KEY",
+      "label": "Cohere multimodal embedding key",
+      "optional": true
+    },
+    {
+      "key": "VOYAGE_API_KEY",
+      "label": "Voyage multimodal embedding key",
+      "optional": true
+    }
+  ],
+  "peerProviders": ["builder-browser", "figma", "google-drive", "notion"],
+  "eject": {
+    "sourceRoot": "src",
+    "targetDirectory": "packages/creative-context"
+  }
+}

package/dist/actions/confirm-canonical-logo.d.ts

@@ -0,0 +1,6 @@
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    suggestionId: string;
+    decision: "confirm" | "reject";
+}, import("../types.js").CreativeContextSuggestion>;
+export default _default;
+//# sourceMappingURL=confirm-canonical-logo.d.ts.map

package/dist/actions/confirm-canonical-logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-canonical-logo.d.ts","sourceRoot":"","sources":["../../src/actions/confirm-canonical-logo.ts"],"names":[],"mappings":""}

package/dist/actions/confirm-canonical-logo.js

@@ -0,0 +1,19 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+import { decideCanonicalLogoSuggestion } from "../store/index.js";
+export default defineAction({
+    description: "Confirm or reject a proposed canonical logo after review.",
+    schema: z.object({
+        suggestionId: z.string().min(1),
+        decision: z.enum(["confirm", "reject"]),
+    }),
+    needsApproval: true,
+    publicAgent: {
+        expose: true,
+        readOnly: false,
+        requiresAuth: true,
+        isConsequential: true,
+    },
+    run: decideCanonicalLogoSuggestion,
+});
+//# sourceMappingURL=confirm-canonical-logo.js.map

package/dist/actions/confirm-canonical-logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-canonical-logo.js","sourceRoot":"","sources":["../../src/actions/confirm-canonical-logo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAElE,eAAe,YAAY,CAAC;IAC1B,WAAW,EAAE,2DAA2D;IACxE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;KACxC,CAAC;IACF,aAAa,EAAE,IAAI;IACnB,WAAW,EAAE;QACX,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;KACtB;IACD,GAAG,EAAE,6BAA6B;CACnC,CAAC,CAAC"}

package/dist/actions/continue-context-import.d.ts

@@ -0,0 +1,22 @@
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    jobId: string;
+}, {
+    job: {
+        id: string;
+        sourceId: string | null;
+        kind: import("../types.js").ContextJobKind;
+        status: import("../types.js").ContextJobStatus;
+        mode: import("../types.js").ContextImportMode | null;
+        progressCurrent: number;
+        progressTotal: number | null;
+        attempts: number;
+        nextResumeAt: string | null;
+        result: unknown;
+        error: {} | null;
+        createdAt: string;
+        startedAt: string | null;
+        completedAt: string | null;
+    } | null;
+}>;
+export default _default;
+//# sourceMappingURL=continue-context-import.d.ts.map

package/dist/actions/continue-context-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue-context-import.d.ts","sourceRoot":"","sources":["../../src/actions/continue-context-import.ts"],"names":[],"mappings":""}

package/dist/actions/continue-context-import.js

@@ -0,0 +1,13 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+import { serializePublicJob } from "../server/public-serialization.js";
+import { continueJob } from "../store/index.js";
+export default defineAction({
+    description: "Resume a yielded or failed creative-context import from its durable checkpoint.",
+    schema: z.object({ jobId: z.string().min(1) }),
+    publicAgent: { expose: true, readOnly: false, requiresAuth: true },
+    run: async ({ jobId }) => ({
+        job: serializePublicJob(await continueJob(jobId)),
+    }),
+});
+//# sourceMappingURL=continue-context-import.js.map

package/dist/actions/continue-context-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue-context-import.js","sourceRoot":"","sources":["../../src/actions/continue-context-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,iFAAiF;IACnF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;IAClE,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACzB,GAAG,EAAE,kBAAkB,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;KAClD,CAAC;CACH,CAAC,CAAC"}

package/dist/actions/creative-context-a2a.d.ts

@@ -0,0 +1,10 @@
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    requestToken: string;
+}, {
+    protocol: string;
+    requestId: string;
+    responseToken: string;
+    instruction: string;
+}>;
+export default _default;
+//# sourceMappingURL=creative-context-a2a.d.ts.map

package/dist/actions/creative-context-a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-context-a2a.d.ts","sourceRoot":"","sources":["../../src/actions/creative-context-a2a.ts"],"names":[],"mappings":""}

package/dist/actions/creative-context-a2a.js

@@ -0,0 +1,66 @@
+import { defineAction } from "@agent-native/core/action";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+import { verifyGenerationArtifactAccessCapability } from "../server/generation-artifact-access.js";
+import { createCreativeContextA2AResponseToken, decodeCreativeContextA2ARequest, } from "../server/isolated-a2a.js";
+export default defineAction({
+    description: "Execute one authenticated, bounded Creative Context A2A protocol request. Use only for an inbound Creative Context machine-protocol message, then return responseToken verbatim.",
+    schema: z
+        .object({
+        requestToken: z.string().min(1).max(512_000),
+    })
+        .strict(),
+    publicAgent: {
+        expose: true,
+        readOnly: false,
+        requiresAuth: true,
+    },
+    run: async ({ requestToken }) => {
+        if (!getRequestUserEmail()) {
+            throw new Error("Creative Context A2A requires a cryptographically verified caller identity");
+        }
+        const request = decodeCreativeContextA2ARequest(requestToken);
+        let result;
+        switch (request.operation) {
+            case "resolve": {
+                const { resolveGenerationCreativeContextLocal } = await import("../server/generation-context.js");
+                result = await resolveGenerationCreativeContextLocal(request.payload);
+                break;
+            }
+            case "validate": {
+                const { validateGenerationCreativeContextLocal } = await import("../server/generation-context.js");
+                result = await validateGenerationCreativeContextLocal(request.payload);
+                break;
+            }
+            case "read": {
+                const { getGenerationCreativeContext } = await import("../store/generation.js");
+                const artifactAccess = request.payload.artifactAccessCapability
+                    ? await verifyGenerationArtifactAccessCapability(request.payload.artifactAccessCapability, request.payload.identity, "read")
+                    : undefined;
+                result = await getGenerationCreativeContext(request.payload.identity, {
+                    artifactAccess,
+                });
+                break;
+            }
+            case "record": {
+                const { recordGenerationCreativeContext } = await import("../store/generation.js");
+                const { artifactAccessCapability, ...record } = request.payload;
+                const artifactAccess = artifactAccessCapability
+                    ? await verifyGenerationArtifactAccessCapability(artifactAccessCapability, record, "record")
+                    : undefined;
+                result = await recordGenerationCreativeContext(record, {
+                    artifactAccess,
+                });
+                break;
+            }
+        }
+        const responseToken = createCreativeContextA2AResponseToken(request, result);
+        return {
+            protocol: "creative-context-a2a-v1",
+            requestId: request.requestId,
+            responseToken,
+            instruction: "Return responseToken verbatim and nothing else.",
+        };
+    },
+});
+//# sourceMappingURL=creative-context-a2a.js.map

package/dist/actions/creative-context-a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-context-a2a.js","sourceRoot":"","sources":["../../src/actions/creative-context-a2a.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,wCAAwC,EAAE,MAAM,yCAAyC,CAAC;AACnG,OAAO,EACL,qCAAqC,EACrC,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAEnC,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,kLAAkL;IACpL,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;KAC7C,CAAC;SACD,MAAM,EAAE;IACX,WAAW,EAAE;QACX,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;KACnB;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QAC9B,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,+BAA+B,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,MAAe,CAAC;QACpB,QAAQ,OAAO,CAAC,SAAS,EAAE,CAAC;YAC1B,KAAK,SAAS,EAAE,CAAC;gBACf,MAAM,EAAE,qCAAqC,EAAE,GAC7C,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;gBAClD,MAAM,GAAG,MAAM,qCAAqC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACtE,MAAM;YACR,CAAC;YACD,KAAK,UAAU,EAAE,CAAC;gBAChB,MAAM,EAAE,sCAAsC,EAAE,GAC9C,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;gBAClD,MAAM,GAAG,MAAM,sCAAsC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACvE,MAAM;YACR,CAAC;YACD,KAAK,MAAM,EAAE,CAAC;gBACZ,MAAM,EAAE,4BAA4B,EAAE,GACpC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBACzC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB;oBAC7D,CAAC,CAAC,MAAM,wCAAwC,CAC5C,OAAO,CAAC,OAAO,CAAC,wBAAwB,EACxC,OAAO,CAAC,OAAO,CAAC,QAAQ,EACxB,MAAM,CACP;oBACH,CAAC,CAAC,SAAS,CAAC;gBACd,MAAM,GAAG,MAAM,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;oBACpE,cAAc;iBACf,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,QAAQ,EAAE,CAAC;gBACd,MAAM,EAAE,+BAA+B,EAAE,GACvC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBACzC,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;gBAChE,MAAM,cAAc,GAAG,wBAAwB;oBAC7C,CAAC,CAAC,MAAM,wCAAwC,CAC5C,wBAAwB,EACxB,MAAM,EACN,QAAQ,CACT;oBACH,CAAC,CAAC,SAAS,CAAC;gBACd,MAAM,GAAG,MAAM,+BAA+B,CAAC,MAAM,EAAE;oBACrD,cAAc;iBACf,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;QACH,CAAC;QACD,MAAM,aAAa,GAAG,qCAAqC,CACzD,OAAO,EACP,MAAM,CACP,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,yBAAyB;YACnC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa;YACb,WAAW,EAAE,iDAAiD;SAC/D,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/actions/get-brand-profile.d.ts

@@ -0,0 +1,33 @@
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    profileId?: string | undefined;
+}, {
+    profile: import("../types.js").BrandProfile | null;
+    dna: {
+        id: string;
+        profileId: string;
+        versionNumber: number;
+        contentHash: string;
+        status: "draft" | "proposed" | "published";
+        evidence: Array<{
+            itemId: string;
+            itemVersionId: string;
+        }>;
+        createdAt: string;
+        payload: unknown;
+    } | null;
+    versions: {
+        id: string;
+        profileId: string;
+        versionNumber: number;
+        contentHash: string;
+        status: "draft" | "proposed" | "published";
+        evidence: Array<{
+            itemId: string;
+            itemVersionId: string;
+        }>;
+        createdAt: string;
+        payload: unknown;
+    }[];
+}>;
+export default _default;
+//# sourceMappingURL=get-brand-profile.d.ts.map

package/dist/actions/get-brand-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-brand-profile.d.ts","sourceRoot":"","sources":["../../src/actions/get-brand-profile.ts"],"names":[],"mappings":""}

package/dist/actions/get-brand-profile.js

@@ -0,0 +1,13 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+import { serializePublicBrandProfile } from "../server/public-serialization.js";
+import { getBrandProfile } from "../store/index.js";
+export default defineAction({
+    description: "Get an accessible brand profile and its current published DNA version.",
+    schema: z.object({ profileId: z.string().min(1).optional() }),
+    http: { method: "GET" },
+    readOnly: true,
+    publicAgent: { expose: true, readOnly: true, requiresAuth: true },
+    run: async (input) => serializePublicBrandProfile(await getBrandProfile(input)),
+});
+//# sourceMappingURL=get-brand-profile.js.map

package/dist/actions/get-brand-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-brand-profile.js","sourceRoot":"","sources":["../../src/actions/get-brand-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,wEAAwE;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC7D,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;IACjE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CACnB,2BAA2B,CAAC,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;CAC5D,CAAC,CAAC"}

package/dist/actions/get-context-import-status.d.ts

@@ -0,0 +1,22 @@
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    jobId: string;
+}, {
+    job: {
+        id: string;
+        sourceId: string | null;
+        kind: import("../types.js").ContextJobKind;
+        status: import("../types.js").ContextJobStatus;
+        mode: import("../types.js").ContextImportMode | null;
+        progressCurrent: number;
+        progressTotal: number | null;
+        attempts: number;
+        nextResumeAt: string | null;
+        result: unknown;
+        error: {} | null;
+        createdAt: string;
+        startedAt: string | null;
+        completedAt: string | null;
+    } | null;
+}>;
+export default _default;
+//# sourceMappingURL=get-context-import-status.d.ts.map

package/dist/actions/get-context-import-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-import-status.d.ts","sourceRoot":"","sources":["../../src/actions/get-context-import-status.ts"],"names":[],"mappings":""}

package/dist/actions/get-context-import-status.js

@@ -0,0 +1,12 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+import { serializePublicJob } from "../server/public-serialization.js";
+import { getJob } from "../store/index.js";
+export default defineAction({
+    description: "Get the persisted status and checkpoint progress of an import.",
+    schema: z.object({ jobId: z.string().min(1) }),
+    http: { method: "GET" },
+    readOnly: true,
+    run: async ({ jobId }) => ({ job: serializePublicJob(await getJob(jobId)) }),
+});
+//# sourceMappingURL=get-context-import-status.js.map

package/dist/actions/get-context-import-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-import-status.js","sourceRoot":"","sources":["../../src/actions/get-context-import-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,eAAe,YAAY,CAAC;IAC1B,WAAW,EAAE,gEAAgE;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,QAAQ,EAAE,IAAI;IACd,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,kBAAkB,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;CAC7E,CAAC,CAAC"}

package/dist/actions/get-context-item.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./get-creative-context.js";
+//# sourceMappingURL=get-context-item.d.ts.map

package/dist/actions/get-context-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-item.d.ts","sourceRoot":"","sources":["../../src/actions/get-context-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/actions/get-context-item.js

@@ -0,0 +1,2 @@
+export { default } from "./get-creative-context.js";
+//# sourceMappingURL=get-context-item.js.map

package/dist/actions/get-context-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-item.js","sourceRoot":"","sources":["../../src/actions/get-context-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/actions/get-context-pack.d.ts

@@ -0,0 +1,7 @@
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    packId: string;
+}, {
+    pack: import("../types.js").ContextPackDetail | null;
+}>;
+export default _default;
+//# sourceMappingURL=get-context-pack.d.ts.map

package/dist/actions/get-context-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-pack.d.ts","sourceRoot":"","sources":["../../src/actions/get-context-pack.ts"],"names":[],"mappings":""}

package/dist/actions/get-context-pack.js

@@ -0,0 +1,12 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+import { getContextPack } from "../store/index.js";
+export default defineAction({
+    description: "Get an accessible context pack with exact immutable item-version evidence.",
+    schema: z.object({ packId: z.string().min(1) }),
+    http: { method: "GET" },
+    readOnly: true,
+    publicAgent: { expose: true, readOnly: true, requiresAuth: true },
+    run: async ({ packId }) => ({ pack: await getContextPack(packId) }),
+});
+//# sourceMappingURL=get-context-pack.js.map

package/dist/actions/get-context-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-pack.js","sourceRoot":"","sources":["../../src/actions/get-context-pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,4EAA4E;IAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;IACjE,GAAG,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;CACpE,CAAC,CAAC"}