@agent-native/creative-context 0.1.0

package/README.md

@@ -0,0 +1,108 @@
+# @agent-native/creative-context
+
+Shared creative-library ingestion, immutable evidence, hybrid retrieval, brand
+context, and generation provenance for Agent Native creative apps.
+
+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/packs, starts resumable import processing, and
+conditionally contributes published brand context to agent prompts. The prompt
+contribution is omitted structurally whenever application state contains
+`{ contextMode: "off" }`.
+
+## 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 snapshots exact `(itemId, itemVersionId)`
+  evidence, lane scores, and reasons 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, and
+every member is rechecked against the viewer's current source access.
+
+## 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.
+
+## 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.package.json

@@ -0,0 +1,104 @@
+{
+  "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",
+    "infer-brand-dna",
+    "list-canonical-logo-candidates",
+    "list-context-connections",
+    "list-context-packs",
+    "list-context-sources",
+    "list-context-suggestions",
+    "manage-brand-profile",
+    "manage-context-pack",
+    "manage-context-source",
+    "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": "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,7 @@
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    jobId: string;
+}, {
+    job: import("../types.js").ContextJob;
+}>;
+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,10 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+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: 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,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,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;CAC9D,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":"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"}

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"}

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

@@ -0,0 +1,119 @@
+import { UNTRUSTED_REFERENCE_ROLE } from "../server/untrusted-reference.js";
+declare const _default: import("@agent-native/core/action").ActionDefinition<{
+    itemId: string;
+    itemVersionId?: string | undefined;
+}, {
+    pendingJobId: string | null;
+    dataRole: "untrusted-reference";
+    item: {
+        id: string;
+        sourceId: string;
+        kind: string;
+        mimeType: string | null;
+        currentVersionId: string;
+        status: import("../types.js").ContextItemStatus;
+        upstreamAccess: import("../types.js").UpstreamAccess;
+        curationStatus: import("../types.js").ContextCurationStatus;
+        curationRank: import("../types.js").ContextCurationRank;
+        starred: boolean;
+        inventoryState: "discovered" | "available" | "removed" | "error";
+        indexState: "pending" | "indexed" | "stale" | "error";
+        tags: string[];
+        colors: string[];
+        sortOrder: number;
+        parentItemId: string | null;
+        createdAt: string;
+        updatedAt: string;
+        canonicalUrl: string | null;
+        hasThumbnail: boolean;
+        dataRole: "untrusted-reference";
+        externalId: string;
+        title: string;
+        provenance: {
+            dataRole: typeof UNTRUSTED_REFERENCE_ROLE;
+            content: string;
+        };
+    };
+    version: {
+        id: string;
+        itemId: string;
+        versionNumber: number;
+        contentHash: string;
+        mimeType: string | null;
+        sourceModifiedAt: string | null;
+        parseStatus: "pending" | "parsed" | "failed";
+        createdAt: string;
+        hasRawSnapshot: boolean;
+        dataRole: "untrusted-reference";
+        title: string;
+        content: string;
+        nativeCode: {
+            dataRole: "untrusted-reference";
+            format: "design-html" | "slides-html";
+            content: string;
+        } | null;
+        summary: string | null;
+        sourceVersion: string | null;
+        parseError: string | null;
+        metadata: {
+            dataRole: typeof UNTRUSTED_REFERENCE_ROLE;
+            content: string;
+        };
+    };
+    chunks: {
+        id: string;
+        itemId: string;
+        itemVersionId: string;
+        ordinal: number;
+        kind: string;
+        startOffset: number | null;
+        endOffset: number | null;
+        tokenCount: number | null;
+        dataRole: "untrusted-reference";
+        text: string;
+        metadata: {
+            dataRole: typeof UNTRUSTED_REFERENCE_ROLE;
+            content: string;
+        };
+    }[];
+    media: {
+        id: string;
+        itemId: string;
+        itemVersionId: string;
+        kind: import("../types.js").ContextMediaInput["kind"];
+        mimeType: string | null;
+        accessMode: "public" | "private" | "expiring";
+        captionStatus: "pending" | "complete" | "failed" | "not-needed";
+        palette: string[];
+        contentHash: string | null;
+        width: number | null;
+        height: number | null;
+        durationMs: number | null;
+        url: string;
+        hasOriginal: boolean;
+        dataRole: "untrusted-reference";
+        altText: string | null;
+        caption: string | null;
+        ocrText: string | null;
+        metadata: {
+            dataRole: typeof UNTRUSTED_REFERENCE_ROLE;
+            content: string;
+        };
+    }[];
+    edges: {
+        id: string;
+        fromItemId: string;
+        fromItemVersionId: string;
+        toItemId: string | null;
+        toItemVersionId: string | null;
+        relation: string;
+        dataRole: "untrusted-reference";
+        toExternalId: string | null;
+        metadata: {
+            dataRole: typeof UNTRUSTED_REFERENCE_ROLE;
+            content: string;
+        };
+    }[];
+}>;
+export default _default;
+//# sourceMappingURL=get-creative-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-creative-context.d.ts","sourceRoot":"","sources":["../../src/actions/get-creative-context.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,wBAAwB,EACzB,MAAM,kCAAkC,CAAC"}