@zarel-ai/sdk 0.6.0

package/dist/resources/contracts.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecResource = void 0;
+const fetch_client_1 = require("../_internal/fetch-client");
+/**
+ * Spec resource (spec-051 US2; renamed from ContractsResource).
+ *
+ * Canonical surface (URLs are bare canonical paths per ADR-0077 D14'):
+ *   - publish(req)    → POST /contract/spec/publish
+ *   - diff(req)       → POST /contract/spec/diff
+ *   - apply(req)      → POST /contract/spec/apply
+ *   - snapshot()      → GET  /contract/spec/snapshot
+ *   - dryRun(req)     → POST /contract/spec/dry-run
+ *   - dryRunReport()  → GET  /contract/spec/dry-run/:id
+ *   - dryRunCancel()  → DELETE /contract/spec/dry-run/:id
+ */
+class SpecResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async publish(request) {
+        return this.client.post('/contract/spec/publish', request, { operationId: 'specPublish' });
+    }
+    async diff(request) {
+        return this.client.post('/contract/spec/diff', request, { operationId: 'specDiff' });
+    }
+    async apply(request) {
+        return this.client.post('/contract/spec/apply', request, { operationId: 'specApply' });
+    }
+    async snapshot(options) {
+        const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
+        // GET /contract/spec/snapshot returns the flat TenantContract body
+        // directly (an authoring carve-out — `ok(contract)`, no {success,data}
+        // envelope; see contract-api routes/spec/snapshot.ts). The response IS
+        // the snapshot — opt out of the transport envelope-unwrap (G1) so the
+        // bare body is returned unchanged (unwrapping would erase entities/roles).
+        const data = await this.client.get('/contract/spec/snapshot', q, { operationId: 'specSnapshot' });
+        const contractVersion = Number(data.contract_version ?? 0);
+        return {
+            tenant_name: String(data.metadata?.name ?? ''),
+            spec_version: String(data.spec_version ?? `v${contractVersion}`),
+            contract_version: contractVersion,
+            hash: `v${contractVersion}`,
+            contract: data,
+        };
+    }
+    /** GET /contract/spec/snapshot/locale-coverage — i18n coverage report for the published snapshot. */
+    async snapshotLocaleCoverage(options) {
+        return this.client.get('/contract/spec/snapshot/locale-coverage', (0, fetch_client_1.localeQueryOrUndefined)(options), { operationId: 'specSnapshotLocaleCoverage' });
+    }
+    /**
+     * GET /contract/spec/snapshot/semantic-diff — semantic diff between two published
+     * contract versions. `from`/`to` are REQUIRED (contract versions, ≥ 1).
+     */
+    async snapshotSemanticDiff(input) {
+        const query = { from: String(input.from), to: String(input.to) };
+        if (input.locale)
+            query.locale = input.locale;
+        return this.client.get('/contract/spec/snapshot/semantic-diff', query, { operationId: 'specSnapshotSemanticDiff' });
+    }
+    /**
+     * Submit an async dry-run.
+     */
+    async dryRun(request) {
+        return this.client.post('/contract/spec/dry-run', request, { operationId: 'specDryRunSubmit' });
+    }
+    /**
+     * Poll the dry-run job for status / report.
+     */
+    async dryRunReport(reportId, options) {
+        const path = `/contract/spec/dry-run/${encodeURIComponent(reportId)}`;
+        const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
+        return q
+            ? this.client.get(path, q, { operationId: 'specDryRunGet' })
+            : this.client.get(path, undefined, { operationId: 'specDryRunGet' });
+    }
+    /**
+     * Cancel a queued / running dry-run job.
+     */
+    async dryRunCancel(reportId) {
+        await this.client.del(`/contract/spec/dry-run/${encodeURIComponent(reportId)}`, { operationId: 'specDryRunCancel' });
+    }
+}
+exports.SpecResource = SpecResource;
+//# sourceMappingURL=contracts.js.map

package/dist/resources/contracts.js.map

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

package/dist/resources/conversation-sessions.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Conversation-session creation resource (T076, SpecKit 010 / ADR-0087).
+ *
+ * Backs `POST /runtime/conversation/sessions` per `contracts/conversation-session-api.md`.
+ * Sessions are now created explicitly — `client.conversation.send` no longer lazily
+ * creates them (FR-C07).
+ */
+import type { FetchClient } from '../_internal/fetch-client';
+export type ConversationScope = 'runtime' | 'contract';
+export interface ConversationSessionCreateInput {
+    channel_name: string;
+    /**
+     * Session-level snapshot of the actor's roles (Spec-019 FR-A07). NOT a
+     * security gate — server-side authorization is DB-resolved. The snapshot
+     * shapes only the LLM-compile prompt's actor context.
+     */
+    rolesSnapshot: string[];
+    scope: ConversationScope;
+    /** Optional pin — the session will use this service unless overridden per-turn (FR-C04). */
+    llmService?: string;
+    userName?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ConversationSessionResponse {
+    session_key: string;
+    user_name: string;
+    channel_name: string;
+    /**
+     * Session-level snapshot of the actor's roles (Spec-019 FR-A07). NOT a
+     * security gate — exposed for observability / UI display only.
+     */
+    roles_snapshot: string[];
+    scope: ConversationScope;
+    llm_service_name: string | null;
+    status: string;
+    turn_count: number;
+    created_at: string;
+    updated_at: string;
+    last_activity: string;
+}
+/** @deprecated G1: the transport unwraps the envelope — methods return the
+ * bare `ConversationSessionResponse`. Kept as an alias for the exported name. */
+export type ConversationSessionEnvelope = ConversationSessionResponse;
+/**
+ * `POST /runtime/conversation/sessions` only.
+ *
+ * This resource used to carry `get` and `delete` as well, mirroring a duplication
+ * that also existed in the API: two routers registered the same three paths and
+ * mount order picked the winner. The published contract settled it —
+ * `getConversationSession` is declared "with turns" — so the session READ lives on
+ * `ConversationResource.session()` (`ConversationSessionDetailResponse`) and the
+ * clear on `ConversationResource.deleteSession()`. `client.runtime.conversation.
+ * sessions` already routed to exactly those; the two methods here were dead in the
+ * composite and, once the route started returning the detail, declared a shape it
+ * no longer sends.
+ */
+export declare class ConversationSessionsResource {
+    private readonly client;
+    constructor(client: FetchClient);
+    create(input: ConversationSessionCreateInput): Promise<ConversationSessionResponse>;
+}
+//# sourceMappingURL=conversation-sessions.d.ts.map

package/dist/resources/conversation-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-sessions.d.ts","sourceRoot":"","sources":["../../src/resources/conversation-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,8BAA8B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,iBAAiB,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;iFACiF;AACjF,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,qBAAa,4BAA4B;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,MAAM,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAc5F"}

package/dist/resources/conversation-sessions.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Conversation-session creation resource (T076, SpecKit 010 / ADR-0087).
+ *
+ * Backs `POST /runtime/conversation/sessions` per `contracts/conversation-session-api.md`.
+ * Sessions are now created explicitly — `client.conversation.send` no longer lazily
+ * creates them (FR-C07).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationSessionsResource = void 0;
+/**
+ * `POST /runtime/conversation/sessions` only.
+ *
+ * This resource used to carry `get` and `delete` as well, mirroring a duplication
+ * that also existed in the API: two routers registered the same three paths and
+ * mount order picked the winner. The published contract settled it —
+ * `getConversationSession` is declared "with turns" — so the session READ lives on
+ * `ConversationResource.session()` (`ConversationSessionDetailResponse`) and the
+ * clear on `ConversationResource.deleteSession()`. `client.runtime.conversation.
+ * sessions` already routed to exactly those; the two methods here were dead in the
+ * composite and, once the route started returning the detail, declared a shape it
+ * no longer sends.
+ */
+class ConversationSessionsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(input) {
+        // No `session_key`: the SERVER mints it and REFUSES a body that carries one
+        // (runtime-api `conversation-sessions.ts` — a client-chosen key was guessable,
+        // squattable, and an existence oracle). Read the minted key off the response.
+        const body = {
+            channel_name: input.channel_name,
+            roles_snapshot: input.rolesSnapshot,
+            scope: input.scope,
+        };
+        if (input.llmService !== undefined)
+            body.llm_service = input.llmService;
+        if (input.userName !== undefined)
+            body.user_name = input.userName;
+        if (input.metadata !== undefined)
+            body.metadata = input.metadata;
+        return this.client.post('/runtime/conversation/sessions', body, { operationId: 'createConversationSession' });
+    }
+}
+exports.ConversationSessionsResource = ConversationSessionsResource;
+//# sourceMappingURL=conversation-sessions.js.map

package/dist/resources/conversation-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-sessions.js","sourceRoot":"","sources":["../../src/resources/conversation-sessions.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA2CH;;;;;;;;;;;;GAYG;AACH,MAAa,4BAA4B;IACR;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,KAAqC;QAC9C,4EAA4E;QAC5E,+EAA+E;QAC/E,8EAA8E;QAC9E,MAAM,IAAI,GAA4B;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,cAAc,EAAE,KAAK,CAAC,aAAa;YACnC,KAAK,EAAE,KAAK,CAAC,KAAK;SACrB,CAAC;QACF,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACxE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;QAClE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAA8B,gCAAgC,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAC/I,CAAC;CACJ;AAjBD,oEAiBC"}

package/dist/resources/conversation.d.ts

@@ -0,0 +1,48 @@
+import { type FetchClient } from '../_internal/fetch-client';
+import { PagePromise } from '../_internal/pagination';
+import type { ConversationRequest, ConversationResponse } from '../types/conversation';
+import type { ConversationSessionListParams, ConversationSessionListResponse, ConversationSessionDetailResponse, ConversationSessionActionsResponse, ConversationSessionSummary } from '../types/conversation-sessions';
+import type { LocaleOptions } from '../types/locale';
+export declare class ConversationResource {
+    private readonly client;
+    constructor(client: FetchClient);
+    /**
+     * Send a natural language message to the cognitive agent.
+     *
+     * spec-039 FR-026: pass `{locale: 'es'}` to override the actor's
+     * `preferences.language` JWT claim for *this turn only*. Useful for
+     * preview/testing and for actors whose stored preference does not
+     * match their current need. Omit for canonical server-side resolution
+     * (JWT preferences.language → canonical).
+     */
+    send(request: ConversationRequest, options?: LocaleOptions): Promise<ConversationResponse>;
+    /**
+     * Soft-delete a conversation session (sets status='cleared' on the row, keeping
+     * history for audit). Canonical route per ADR-0077 P7 runtime-mutable tier.
+     */
+    deleteSession(sessionKey: string): Promise<void>;
+    /**
+     * List past conversation sessions for the authenticated user.
+     *
+     * Returns a {@link PagePromise}: `await` it for the first page
+     * (`ConversationSessionSummary[]` — unchanged), or `for await (… of …)` to
+     * auto-paginate over every session. This endpoint has no `total`/cursor in
+     * its wire shape, so iteration advances by page size and stops when a page
+     * returns fewer items than the page size; when the row count is an exact
+     * multiple of the page size, one extra request returns an empty page and
+     * iteration then stops (no items missed or duplicated). Pass `{ signal }`
+     * to cancel an in-flight page; `break` also stops further fetches.
+     */
+    sessions(params?: ConversationSessionListParams, options?: LocaleOptions & {
+        signal?: AbortSignal;
+    }): PagePromise<ConversationSessionListResponse, ConversationSessionSummary>;
+    /**
+     * Get a conversation session with its full turn history.
+     */
+    session(sessionKey: string, options?: LocaleOptions): Promise<ConversationSessionDetailResponse>;
+    /**
+     * Get actions (record mutations) linked to a conversation session.
+     */
+    actions(sessionKey: string, options?: LocaleOptions): Promise<ConversationSessionActionsResponse>;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/resources/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/resources/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAA0B,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,WAAW,EAAoC,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EACR,mBAAmB,EACnB,oBAAoB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACR,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,kCAAkC,EAClC,0BAA0B,EAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQrD,qBAAa,oBAAoB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQhG;;;OAGG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;;;;;;;;;;OAWG;IACH,QAAQ,CACJ,MAAM,CAAC,EAAE,6BAA6B,EACtC,OAAO,CAAC,EAAE,aAAa,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnD,WAAW,CAAC,+BAA+B,EAAE,0BAA0B,CAAC;IA+B3E;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iCAAiC,CAAC;IAQtG;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kCAAkC,CAAC;CAO1G"}

package/dist/resources/conversation.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationResource = void 0;
+const fetch_client_1 = require("../_internal/fetch-client");
+const pagination_1 = require("../_internal/pagination");
+function appendLocale(path, options) {
+    if (!options?.locale)
+        return path;
+    const sep = path.includes('?') ? '&' : '?';
+    return `${path}${sep}locale=${encodeURIComponent(options.locale)}`;
+}
+class ConversationResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Send a natural language message to the cognitive agent.
+     *
+     * spec-039 FR-026: pass `{locale: 'es'}` to override the actor's
+     * `preferences.language` JWT claim for *this turn only*. Useful for
+     * preview/testing and for actors whose stored preference does not
+     * match their current need. Omit for canonical server-side resolution
+     * (JWT preferences.language → canonical).
+     */
+    async send(request, options) {
+        // POST /runtime/conversation/send returns the flat ConversationResponse body directly
+        // (`res.json(response)`, no {success,data} envelope). Opt out of the
+        // transport envelope-unwrap (G1): a reply with only envelope-shaped keys
+        // (e.g. {success, message}) would otherwise be misread as an envelope.
+        return this.client.post(appendLocale('/runtime/conversation/send', options), request, { operationId: 'runtimeConversationSend' });
+    }
+    /**
+     * Soft-delete a conversation session (sets status='cleared' on the row, keeping
+     * history for audit). Canonical route per ADR-0077 P7 runtime-mutable tier.
+     */
+    async deleteSession(sessionKey) {
+        await this.client.del(`/runtime/conversation/sessions/${encodeURIComponent(sessionKey)}`, { operationId: 'clearConversationSession' });
+    }
+    /**
+     * List past conversation sessions for the authenticated user.
+     *
+     * Returns a {@link PagePromise}: `await` it for the first page
+     * (`ConversationSessionSummary[]` — unchanged), or `for await (… of …)` to
+     * auto-paginate over every session. This endpoint has no `total`/cursor in
+     * its wire shape, so iteration advances by page size and stops when a page
+     * returns fewer items than the page size; when the row count is an exact
+     * multiple of the page size, one extra request returns an empty page and
+     * iteration then stops (no items missed or duplicated). Pass `{ signal }`
+     * to cancel an in-flight page; `break` also stops further fetches.
+     */
+    sessions(params, options) {
+        const buildPath = (offset, limit) => {
+            const query = new URLSearchParams();
+            if (params?.channel_name)
+                query.set('channel_name', params.channel_name);
+            if (params?.status)
+                query.set('status', params.status);
+            if (params?.from)
+                query.set('from', params.from);
+            if (params?.to)
+                query.set('to', params.to);
+            if (limit !== undefined)
+                query.set('limit', String(limit));
+            if (offset !== undefined)
+                query.set('offset', String(offset));
+            if (options?.locale)
+                query.set('locale', options.locale);
+            const qs = query.toString();
+            return qs ? `/runtime/conversation/sessions?${qs}` : '/runtime/conversation/sessions';
+        };
+        const signal = options?.signal;
+        const fetchPage = (p) => {
+            const path = buildPath(p.offset, p.limit);
+            return this.client.get(path, undefined, { operationId: 'listConversationSessions', ...(signal ? { signal } : {}) });
+        };
+        return new pagination_1.PagePromise(fetchPage, (0, pagination_1.bareArrayOffset)(), {
+            ...(params?.limit !== undefined ? { limit: params.limit } : {}),
+            ...(params?.offset !== undefined ? { offset: params.offset } : {}),
+        });
+    }
+    /**
+     * Get a conversation session with its full turn history.
+     */
+    async session(sessionKey, options) {
+        const path = `/runtime/conversation/sessions/${encodeURIComponent(sessionKey)}`;
+        const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
+        return q
+            ? this.client.get(path, q, { operationId: 'getConversationSession' })
+            : this.client.get(path, undefined, { operationId: 'getConversationSession' });
+    }
+    /**
+     * Get actions (record mutations) linked to a conversation session.
+     */
+    async actions(sessionKey, options) {
+        const path = `/runtime/conversation/sessions/${encodeURIComponent(sessionKey)}/actions`;
+        const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
+        return q
+            ? this.client.get(path, q, { operationId: 'listConversationActions' })
+            : this.client.get(path, undefined, { operationId: 'listConversationActions' });
+    }
+}
+exports.ConversationResource = ConversationResource;
+//# sourceMappingURL=conversation.js.map

package/dist/resources/conversation.js.map

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

package/dist/resources/embedding-credentials.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Embedding credential management resource (embedding-provider-registry, FR-018).
+ *
+ * Per-(tenant, declared embedding service) credentials — keyed on the name from
+ * `embeddings.services[]` (FR-023), never the provider, which is not an identity
+ * and is resolved server-side from that declaration. Write-only on the secret:
+ * `put` accepts the credential blob but no read endpoint ever returns it; `get` /
+ * `list` return only masked metadata.
+ *
+ * Authorization: tenant-level superuser. The wire surface returns 404
+ * indistinguishable from "not configured" when unauthorized (SEC.V12), and an
+ * empty list from `list`.
+ */
+import { type FetchClient } from '../_internal/fetch-client';
+import type { LocaleOptions } from '../types/locale';
+export interface EmbeddingCredentialMetadata {
+    tenant_name: string;
+    /** The declared `embeddings.services[].name` this credential keys to. */
+    service_name: string;
+    /** "••••" + the credential fingerprint. Read-only; never the secret. */
+    credential_masked: string;
+    created_by: string;
+    updated_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export type EmbeddingCredentialsListResponse = EmbeddingCredentialMetadata[];
+export type EmbeddingCredentialResponse = EmbeddingCredentialMetadata;
+/** apiKey providers (gemini, openai, anthropic-via-Voyage). */
+export interface EmbeddingApiKeyCredentialInput {
+    apiKey: string;
+    baseUrl?: string;
+}
+/** Amazon Bedrock — static AWS credentials. */
+export interface EmbeddingAwsCredentialInput {
+    accessKeyId: string;
+    secretAccessKey: string;
+    region: string;
+    sessionToken?: string;
+}
+export type EmbeddingCredentialPutInput = EmbeddingApiKeyCredentialInput | EmbeddingAwsCredentialInput;
+export declare class EmbeddingCredentialsResource {
+    private readonly client;
+    constructor(client: FetchClient);
+    /** List masked metadata for every stored embedding-service credential. */
+    list(options?: LocaleOptions): Promise<EmbeddingCredentialsListResponse>;
+    /** Fetch masked metadata for one declared service's credential. 404 if not authorized / not configured. */
+    get(serviceName: string, options?: LocaleOptions): Promise<EmbeddingCredentialResponse>;
+    /**
+     * Set / replace a declared service's credential. Idempotent UPSERT.
+     *
+     * `serviceName` is the `embeddings.services[].name` the contract declares;
+     * the server resolves its provider and validates `input` against that
+     * provider's schema, so the blob shape follows the DECLARATION, not the path.
+     */
+    put(serviceName: string, input: EmbeddingCredentialPutInput): Promise<EmbeddingCredentialResponse>;
+    /** Remove a declared service's credential (soft-delete + sensitive wipe). */
+    delete(serviceName: string): Promise<void>;
+}
+//# sourceMappingURL=embedding-credentials.d.ts.map

package/dist/resources/embedding-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-credentials.d.ts","sourceRoot":"","sources":["../../src/resources/embedding-credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,2BAA2B;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,gCAAgC,GAAG,2BAA2B,EAAE,CAAC;AAE7E,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;AAEtE,+DAA+D;AAC/D,MAAM,WAAW,8BAA8B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,2BAA2B;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,2BAA2B,GAAG,8BAA8B,GAAG,2BAA2B,CAAC;AAEvG,qBAAa,4BAA4B;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD,0EAA0E;IACpE,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAI9E,2GAA2G;IACrG,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAQ7F;;;;;;OAMG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAcxG,6EAA6E;IACvE,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}

package/dist/resources/embedding-credentials.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Embedding credential management resource (embedding-provider-registry, FR-018).
+ *
+ * Per-(tenant, declared embedding service) credentials — keyed on the name from
+ * `embeddings.services[]` (FR-023), never the provider, which is not an identity
+ * and is resolved server-side from that declaration. Write-only on the secret:
+ * `put` accepts the credential blob but no read endpoint ever returns it; `get` /
+ * `list` return only masked metadata.
+ *
+ * Authorization: tenant-level superuser. The wire surface returns 404
+ * indistinguishable from "not configured" when unauthorized (SEC.V12), and an
+ * empty list from `list`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingCredentialsResource = void 0;
+const fetch_client_1 = require("../_internal/fetch-client");
+class EmbeddingCredentialsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List masked metadata for every stored embedding-service credential. */
+    async list(options) {
+        return this.client.get('/runtime/embedding-credentials', (0, fetch_client_1.localeQuery)(options), { operationId: 'listEmbeddingCredentials' });
+    }
+    /** Fetch masked metadata for one declared service's credential. 404 if not authorized / not configured. */
+    async get(serviceName, options) {
+        return this.client.get(`/runtime/embedding-credentials/${encodeURIComponent(serviceName)}`, (0, fetch_client_1.localeQuery)(options), { operationId: 'getEmbeddingCredential' });
+    }
+    /**
+     * Set / replace a declared service's credential. Idempotent UPSERT.
+     *
+     * `serviceName` is the `embeddings.services[].name` the contract declares;
+     * the server resolves its provider and validates `input` against that
+     * provider's schema, so the blob shape follows the DECLARATION, not the path.
+     */
+    async put(serviceName, input) {
+        const body = { ...input };
+        // Mirror the LLM resource's apiKey casing (wire field is `baseURL`).
+        if ('baseUrl' in input && input.baseUrl !== undefined) {
+            delete body.baseUrl;
+            body.baseURL = input.baseUrl;
+        }
+        return this.client.put(`/runtime/embedding-credentials/${encodeURIComponent(serviceName)}`, body, { operationId: 'setEmbeddingCredential' });
+    }
+    /** Remove a declared service's credential (soft-delete + sensitive wipe). */
+    async delete(serviceName) {
+        await this.client.del(`/runtime/embedding-credentials/${encodeURIComponent(serviceName)}`, { operationId: 'deleteEmbeddingCredential' });
+    }
+}
+exports.EmbeddingCredentialsResource = EmbeddingCredentialsResource;
+//# sourceMappingURL=embedding-credentials.js.map

package/dist/resources/embedding-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-credentials.js","sourceRoot":"","sources":["../../src/resources/embedding-credentials.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,4DAA0E;AAmC1E,MAAa,4BAA4B;IACR;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,0EAA0E;IAC1E,KAAK,CAAC,IAAI,CAAC,OAAuB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAmC,gCAAgC,EAAE,IAAA,0BAAW,EAAC,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC,CAAC;IAClK,CAAC;IAED,2GAA2G;IAC3G,KAAK,CAAC,GAAG,CAAC,WAAmB,EAAE,OAAuB;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAClB,kCAAkC,kBAAkB,CAAC,WAAW,CAAC,EAAE,EACnE,IAAA,0BAAW,EAAC,OAAO,CAAC,EACpB,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAC5C,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,WAAmB,EAAE,KAAkC;QAC7D,MAAM,IAAI,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;QACnD,qEAAqE;QACrE,IAAI,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC,OAAO,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAClB,kCAAkC,kBAAkB,CAAC,WAAW,CAAC,EAAE,EACnE,IAAI,EACJ,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAC5C,CAAC;IACN,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,MAAM,CAAC,WAAmB;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kCAAkC,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAC7I,CAAC;CACJ;AA1CD,oEA0CC"}

package/dist/resources/entities.d.ts

@@ -0,0 +1,66 @@
+import { type FetchClient } from '../_internal/fetch-client';
+import type { EntityInput, FieldDefinitionInput } from '../types/entities';
+import type { LocaleOptions } from '../types/locale';
+import type { EntityListPayload, EntityPayload, EntityMutationPayload } from '../generated';
+export declare class EntitiesResource {
+    private readonly client;
+    constructor(client: FetchClient);
+    /**
+     * List all entities for the current tenant.
+     * spec-039: pass `{locale: 'es'}` to receive Spanish labels; omit for
+     * server-side fallback (JWT preferences.language → canonical).
+     */
+    list(options?: LocaleOptions): Promise<EntityListPayload>;
+    /**
+     * Create a new entity.
+     */
+    create(input: EntityInput): Promise<EntityMutationPayload>;
+    /**
+     * Get a single entity by name.
+     */
+    get(entityName: string, options?: LocaleOptions): Promise<EntityPayload>;
+    /**
+     * Update an entity definition.
+     */
+    update(entityName: string, input: Partial<EntityInput>): Promise<EntityMutationPayload>;
+    /**
+     * Delete an entity.
+     */
+    delete(entityName: string): Promise<void>;
+    /**
+     * Add a field to an entity.
+     */
+    addField(entityName: string, field: FieldDefinitionInput): Promise<EntityMutationPayload>;
+    /**
+     * Update a field on an entity.
+     */
+    updateField(entityName: string, fieldName: string, update: Partial<FieldDefinitionInput>): Promise<EntityMutationPayload>;
+    /**
+     * Delete a field from an entity.
+     */
+    deleteField(entityName: string, fieldName: string): Promise<void>;
+    /**
+     * Replace an entity definition wholesale (PUT). {@link update} is the partial (PATCH) counterpart.
+     */
+    replace(entityName: string, input: EntityInput): Promise<EntityMutationPayload>;
+    /**
+     * List an entity's fields. The response is `{ entity_name, fields }` — the field
+     * array is nested under `fields` (the endpoint wraps it, unlike the transition/step lists).
+     */
+    listFields(entityName: string, options?: LocaleOptions): Promise<Record<string, unknown>>;
+    /**
+     * Read a single field definition.
+     */
+    getField(entityName: string, fieldName: string, options?: LocaleOptions): Promise<Record<string, unknown>>;
+    /**
+     * Replace a field definition wholesale (PUT). {@link updateField} is the partial (PATCH) counterpart.
+     */
+    replaceField(entityName: string, fieldName: string, input: FieldDefinitionInput): Promise<EntityMutationPayload>;
+    listFieldTransitions(entityName: string, fieldName: string, options?: LocaleOptions): Promise<Record<string, unknown>[]>;
+    getFieldTransition(entityName: string, fieldName: string, from: string, to: string, options?: LocaleOptions): Promise<Record<string, unknown>>;
+    createFieldTransition(entityName: string, fieldName: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
+    replaceFieldTransition(entityName: string, fieldName: string, from: string, to: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
+    patchFieldTransition(entityName: string, fieldName: string, from: string, to: string, patch: Record<string, unknown>): Promise<Record<string, unknown>>;
+    deleteFieldTransition(entityName: string, fieldName: string, from: string, to: string): Promise<void>;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/resources/entities.d.ts.map

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