@beacon-build/sdk 2.4.3 → 2.5.0

package/dist/clients/admin/executions.client.d.ts

@@ -0,0 +1,68 @@
+import type { HttpClient } from '../../transport/http-client.js';
+/** F381: query params for the skill-execution list read (mirrors `listSkillExecutionsQuerySchema`). */
+export interface ListSkillExecutionsParams {
+    project?: string;
+    status?: 'running' | 'completed' | 'failed';
+    integrationStatus?: 'pending' | 'merged' | 'discarded';
+    topLevelOnly?: boolean;
+    /** C856: scope to one task's own executions (the route already accepts this — see
+     *  `listSkillExecutionsQuerySchema`) — the task-detail Metrics & Cost tab's Executions list. */
+    taskId?: string;
+    /** C909: scope to one agent's own executions (the route already accepts this — see
+     *  `listSkillExecutionsQuerySchema`) — the Agent-Detail Activity tab's live-executions block. */
+    agentId?: string;
+    limit?: number;
+}
+/** F381/AC-4: query params for the instance list read. */
+export interface ListInstancesParams {
+    project?: string;
+    /** Multi-valued (IN filter) — joined into the CSV `statuses` query param. */
+    statuses?: string[];
+    /** C856: scope to one task's own instances (the route already accepts this — see
+     *  `listInstancesQuerySchema`) — the task-detail Metrics & Cost tab's Executions list. */
+    taskId?: string;
+    /** C909: scope to one agent's own instances (the route already accepts this — see
+     *  `listInstancesQuerySchema`) — the Agent-Detail Activity tab's live-executions block. */
+    agentId?: string;
+    limit?: number;
+}
+/**
+ * AdminExecutionsClient — by-id drill-down reads for the F307 Execution Log UI, plus the F381
+ * Läufe view's cross-cutting list reads. Wraps existing routes (F381 adds no server endpoint
+ * except the AC-4 `statuses` filter on the pre-existing `/workflow-instances/instances`):
+ *  - F308 `GET /workflow-instances/workflow-executions/:id` → `{ data: ExecutionDetail }`
+ *  - `GET /skill-executions/:id` → `{ data: SkillExecution }` (mapped to ExecutionDetail by the
+ *    consumer). Renamed from `/skills/:id` under FS54 Chore 6 (C567).
+ *  - F381 `GET /skill-executions` → `{ data: SkillExecution[], total }` (renamed from `/skills`).
+ *  - F381 `GET /workflow-instances/instances` → `{ data: WorkflowInstance[] }`
+ *  - F381 `GET /workflow-instances/definitions/:id` → `{ data: WorkflowDefinition }` (name/type
+ *    resolution for an instance row; existing route, not new).
+ *
+ * C568 (FS54/7): paths renamed from `/workflow-runner/*` to `/workflow-instances/*` — the
+ * consolidated canonical resource; no shape/contract change.
+ */
+export declare class AdminExecutionsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** F308: unified ExecutionDetail for a SOP/workflow run by instance id. */
+    workflowDetail<T>(id: string): Promise<T>;
+    /** Raw skill execution by id; the platform service maps it to ExecutionDetail. */
+    skillExecution<T>(id: string): Promise<T>;
+    /** C352/AC-4: flattened friction occurrences for a project, grouped by repetition client-side. */
+    projectFrictions<T>(project: string): Promise<T>;
+    /** F381: raw skill-execution list (Live/Roster/Recent sections read this directly). */
+    listSkillExecutions<T>(params: ListSkillExecutionsParams): Promise<T>;
+    /** F381/AC-4: raw workflow-instance list, `statuses` joined into one CSV param. */
+    listInstances<T>(params: ListInstancesParams): Promise<T>;
+    /** F381: resolve a workflow instance's definition (name + type) for card display. */
+    getDefinition<T>(id: string): Promise<T>;
+    /**
+     * F424: vendor-gated force-terminate for a skill execution — distinct from the
+     * self-service `POST /skill-executions/:id/fail`. 403s for a non-vendor caller. Idempotent —
+     * safe to call again on an already-terminal execution. Renamed from
+     * `/admin/executions/:id/terminate` under FS54 Chore 6 (C567) — now a sub-path of the
+     * canonical resource.
+     */
+    terminate<T>(id: string): Promise<T>;
+}
+//# sourceMappingURL=executions.client.d.ts.map

package/dist/clients/admin/executions.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executions.client.d.ts","sourceRoot":"","sources":["../../../src/clients/admin/executions.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,uGAAuG;AACvG,MAAM,WAAW,yBAAyB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;IAC3C,iBAAiB,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;IACtD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;oGACgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;qGACiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;8FAC0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;+FAC2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAYD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAqB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,2EAA2E;IACrE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAM/C,kFAAkF;IAC5E,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/C,kGAAkG;IAC5F,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAMtD,uFAAuF;IACjF,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3E,mFAAmF;IAC7E,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAO/D,qFAAqF;IAC/E,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9C;;;;;;OAMG;IACG,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAG7C"}

package/dist/clients/admin/executions.client.js

@@ -0,0 +1,67 @@
+function qs(params) {
+    const p = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined)
+            continue;
+        p.set(k, String(v));
+    }
+    const s = p.toString();
+    return s ? `?${s}` : '';
+}
+/**
+ * AdminExecutionsClient — by-id drill-down reads for the F307 Execution Log UI, plus the F381
+ * Läufe view's cross-cutting list reads. Wraps existing routes (F381 adds no server endpoint
+ * except the AC-4 `statuses` filter on the pre-existing `/workflow-instances/instances`):
+ *  - F308 `GET /workflow-instances/workflow-executions/:id` → `{ data: ExecutionDetail }`
+ *  - `GET /skill-executions/:id` → `{ data: SkillExecution }` (mapped to ExecutionDetail by the
+ *    consumer). Renamed from `/skills/:id` under FS54 Chore 6 (C567).
+ *  - F381 `GET /skill-executions` → `{ data: SkillExecution[], total }` (renamed from `/skills`).
+ *  - F381 `GET /workflow-instances/instances` → `{ data: WorkflowInstance[] }`
+ *  - F381 `GET /workflow-instances/definitions/:id` → `{ data: WorkflowDefinition }` (name/type
+ *    resolution for an instance row; existing route, not new).
+ *
+ * C568 (FS54/7): paths renamed from `/workflow-runner/*` to `/workflow-instances/*` — the
+ * consolidated canonical resource; no shape/contract change.
+ */
+export class AdminExecutionsClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** F308: unified ExecutionDetail for a SOP/workflow run by instance id. */
+    async workflowDetail(id) {
+        return this.http.getEnvelope(`/workflow-instances/workflow-executions/${encodeURIComponent(id)}`);
+    }
+    /** Raw skill execution by id; the platform service maps it to ExecutionDetail. */
+    async skillExecution(id) {
+        return this.http.getEnvelope(`/skill-executions/${encodeURIComponent(id)}`);
+    }
+    /** C352/AC-4: flattened friction occurrences for a project, grouped by repetition client-side. */
+    async projectFrictions(project) {
+        return this.http.getEnvelope(`/skill-executions/frictions?project=${encodeURIComponent(project)}`);
+    }
+    /** F381: raw skill-execution list (Live/Roster/Recent sections read this directly). */
+    async listSkillExecutions(params) {
+        return this.http.getEnvelope(`/skill-executions${qs({ ...params })}`);
+    }
+    /** F381/AC-4: raw workflow-instance list, `statuses` joined into one CSV param. */
+    async listInstances(params) {
+        const { statuses, ...rest } = params;
+        return this.http.getEnvelope(`/workflow-instances/instances${qs({ ...rest, statuses: statuses?.join(',') })}`);
+    }
+    /** F381: resolve a workflow instance's definition (name + type) for card display. */
+    async getDefinition(id) {
+        return this.http.getEnvelope(`/workflow-instances/definitions/${encodeURIComponent(id)}`);
+    }
+    /**
+     * F424: vendor-gated force-terminate for a skill execution — distinct from the
+     * self-service `POST /skill-executions/:id/fail`. 403s for a non-vendor caller. Idempotent —
+     * safe to call again on an already-terminal execution. Renamed from
+     * `/admin/executions/:id/terminate` under FS54 Chore 6 (C567) — now a sub-path of the
+     * canonical resource.
+     */
+    async terminate(id) {
+        return this.http.post(`/skill-executions/${encodeURIComponent(id)}/terminate`);
+    }
+}
+//# sourceMappingURL=executions.client.js.map

package/dist/clients/admin/executions.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executions.client.js","sourceRoot":"","sources":["../../../src/clients/admin/executions.client.ts"],"names":[],"mappings":"AA+BA,SAAS,EAAE,CAAC,MAA6D;IACrE,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,SAAS;YAAE,SAAQ;QAC7B,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IACvB,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;IACtB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,qBAAqB;IACD;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,2EAA2E;IAC3E,KAAK,CAAC,cAAc,CAAI,EAAU;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CACxB,2CAA2C,kBAAkB,CAAC,EAAE,CAAC,EAAE,CACtE,CAAA;IACL,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,cAAc,CAAI,EAAU;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAI,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAClF,CAAC;IAED,kGAAkG;IAClG,KAAK,CAAC,gBAAgB,CAAI,OAAe;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CACxB,uCAAuC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CACvE,CAAA;IACL,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,mBAAmB,CAAI,MAAiC;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAI,oBAAoB,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;IAC5E,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,aAAa,CAAI,MAA2B;QAC9C,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CACxB,gCAAgC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CACnF,CAAA;IACL,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,aAAa,CAAI,EAAU;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAI,mCAAmC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAChG,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAI,EAAU;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAI,qBAAqB,kBAAkB,CAAC,EAAE,CAAC,YAAY,CAAC,CAAA;IACrF,CAAC;CACJ"}

package/dist/clients/admin/github-proxy.client.d.ts

@@ -0,0 +1,51 @@
+import type { HttpClient } from '../../transport/http-client.js';
+export interface GithubProxyResponse {
+    data: unknown;
+    status: number;
+    headers: Record<string, string>;
+}
+/**
+ * C935 AC-3: one GitHub Release, as surfaced by `releases()` below — the same shape the
+ * Portal's `GitHubServiceImpl.getReleases` maps to (Release, in
+ * apps/platform/src/services/GitHubService.ts), so a caller that already knows that shape
+ * (e.g. beacon-web/F39) gets an identical contract from the SDK.
+ */
+export interface SdkRelease {
+    tag: string;
+    name: string;
+    timestamp: string;
+    url: string;
+    body?: string;
+    author?: string;
+    prerelease: boolean;
+}
+/**
+ * B499: `method` is narrowed to the read verbs the API actually forwards. The server
+ * refuses anything else with 403 METHOD_NOT_ALLOWED (`services/api/src/routes/github.ts`),
+ * because every proxied call travels under the server's GitHub PAT — a write verb here is
+ * an arbitrary write against any repository that token can reach. The wider
+ * `POST | PATCH | PUT | DELETE` union this type used to advertise had no caller: the
+ * portal's `GitHubServiceImpl` is the sole consumer and only ever issues `GET`.
+ */
+export type GithubProxyMethod = 'GET' | 'HEAD';
+export declare class AdminGithubProxyClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    proxy(method: GithubProxyMethod, path: string, body?: unknown): Promise<GithubProxyResponse>;
+    /**
+     * C935 AC-3: project-scoped GitHub Releases read — `releases({project, limit})`
+     * resolves `project`'s own `config.github.repo` (the SAME project-config field the
+     * Portal's Releases panel already reads, `GET /projects/:slug`) and reuses the EXISTING
+     * GitHub-proxy query path (this class's own `proxy()`, → GitHub's `/repos/{repo}/
+     * releases` — the same upstream call `GitHubServiceImpl.getReleases` makes) rather than
+     * inventing a second GitHub-release data path. Works identically for ANY registered
+     * project (beacon-platform, beacon-web, ...) — the call shape never changes, only which
+     * project's repo gets resolved. Returns `[]` (never throws) when the project has no
+     * `config.github.repo` configured — a release-less project is not an error case.
+     */
+    releases(params: {
+        project: string;
+        limit?: number;
+    }): Promise<SdkRelease[]>;
+}
+//# sourceMappingURL=github-proxy.client.d.ts.map

package/dist/clients/admin/github-proxy.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-proxy.client.d.ts","sourceRoot":"","sources":["../../../src/clients/admin/github-proxy.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAGhE,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,OAAO,CAAA;CACtB;AAkBD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAA;AAE9C,qBAAa,sBAAsB;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEvC,KAAK,CACP,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAuBrF"}

package/dist/clients/admin/github-proxy.client.js

@@ -0,0 +1,55 @@
+import { SdkError, statusToSdkCode } from '../../transport/errors.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function mapGithubRelease(r) {
+    return {
+        tag: r.tag_name,
+        name: r.name || r.tag_name,
+        timestamp: r.published_at || r.created_at,
+        url: r.html_url,
+        // C937/AC-9: GitHub's `body` is nullable (an empty-body release sends `body: null`),
+        // but this contract only permits `string | undefined` — normalize `null` to
+        // `undefined` rather than leaking GitHub's own null-vs-undefined distinction.
+        body: r.body ?? undefined,
+        author: r.author?.login,
+        prerelease: r.prerelease,
+    };
+}
+export class AdminGithubProxyClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async proxy(method, path, body) {
+        return this.http.post('/github/proxy', { method, path, body });
+    }
+    /**
+     * C935 AC-3: project-scoped GitHub Releases read — `releases({project, limit})`
+     * resolves `project`'s own `config.github.repo` (the SAME project-config field the
+     * Portal's Releases panel already reads, `GET /projects/:slug`) and reuses the EXISTING
+     * GitHub-proxy query path (this class's own `proxy()`, → GitHub's `/repos/{repo}/
+     * releases` — the same upstream call `GitHubServiceImpl.getReleases` makes) rather than
+     * inventing a second GitHub-release data path. Works identically for ANY registered
+     * project (beacon-platform, beacon-web, ...) — the call shape never changes, only which
+     * project's repo gets resolved. Returns `[]` (never throws) when the project has no
+     * `config.github.repo` configured — a release-less project is not an error case.
+     */
+    async releases(params) {
+        const limit = params.limit ?? 10;
+        const projectResp = await this.http.get(`/projects/${encodeURIComponent(params.project)}`);
+        const github = projectResp?.config?.github;
+        const repo = github?.repo;
+        if (!repo)
+            return [];
+        const { data, status } = await this.proxy('GET', `/repos/${repo}/releases?per_page=${limit}`);
+        // C937/AC-9: `/github/proxy` itself always answers HTTP 200 — the REAL GitHub status
+        // travels in the payload's own `status` field. Discarding it turned a genuine GitHub
+        // 403/404/429/5xx into an indistinguishable `[]`, the exact same shape as "this
+        // project has no `config.github.repo`". Only a genuinely empty 2xx success (or the
+        // no-repo-configured early return above) may legitimately produce `[]`.
+        if (status < 200 || status >= 300) {
+            throw new SdkError(statusToSdkCode(status), `GitHub proxy request failed`, status);
+        }
+        return (Array.isArray(data) ? data : []).map(mapGithubRelease);
+    }
+}
+//# sourceMappingURL=github-proxy.client.js.map

package/dist/clients/admin/github-proxy.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-proxy.client.js","sourceRoot":"","sources":["../../../src/clients/admin/github-proxy.client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAwBrE,8DAA8D;AAC9D,SAAS,gBAAgB,CAAC,CAAM;IAC5B,OAAO;QACH,GAAG,EAAE,CAAC,CAAC,QAAQ;QACf,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ;QAC1B,SAAS,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,UAAU;QACzC,GAAG,EAAE,CAAC,CAAC,QAAQ;QACf,qFAAqF;QACrF,4EAA4E;QAC5E,8EAA8E;QAC9E,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK;QACvB,UAAU,EAAE,CAAC,CAAC,UAAU;KAC3B,CAAA;AACL,CAAC;AAYD,MAAM,OAAO,sBAAsB;IACF;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,KAAK,CAAC,KAAK,CACP,MAAyB,EACzB,IAAY,EACZ,IAAc;QAEd,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAsB,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACvF,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA2C;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAA;QAChC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CACnC,aAAa,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CACpD,CAAA;QACD,MAAM,MAAM,GAAG,WAAW,EAAE,MAAM,EAAE,MAAuC,CAAA;QAC3E,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,CAAA;QACzB,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAA;QAEpB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CACrC,KAAK,EACL,UAAU,IAAI,sBAAsB,KAAK,EAAE,CAC9C,CAAA;QACD,qFAAqF;QACrF,qFAAqF;QACrF,gFAAgF;QAChF,mFAAmF;QACnF,wEAAwE;QACxE,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAChC,MAAM,IAAI,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,6BAA6B,EAAE,MAAM,CAAC,CAAA;QACtF,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAClE,CAAC;CACJ"}

package/dist/clients/admin/memories.client.d.ts

@@ -0,0 +1,69 @@
+import type { AgentContext, Memory, UpsertMemoryInput, MemoryType, MemoryTypeReadable, MemoryScope, DuplicateClusterResult } from '@beacon-build/core';
+import type { HttpClient } from '../../transport/http-client.js';
+export interface MemoryListResult {
+    data: Memory[];
+    meta: {
+        total: number;
+        page?: number;
+        limit?: number;
+    };
+}
+export declare class AdminMemoriesClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    upsert(context: AgentContext, input: UpsertMemoryInput): Promise<Memory>;
+    findForSession(context: AgentContext, opts?: {
+        limit?: number;
+    }): Promise<Memory[]>;
+    list(context: AgentContext, filter?: {
+        type?: MemoryType;
+        scope?: MemoryScope;
+        limit?: number;
+        staleUnusedDays?: number;
+    }): Promise<Memory[]>;
+    delete(context: AgentContext, memoryId: string): Promise<boolean>;
+    deleteByKey(context: AgentContext, key: string, opts?: {
+        global?: boolean;
+    }): Promise<boolean>;
+    searchByVector(context: AgentContext, embedding: number[], opts?: {
+        limit?: number;
+        global?: boolean;
+    }): Promise<Memory[]>;
+    /**
+     * List memories filtered by agentId and/or project — for admin UI use.
+     * Unlike `list()`, this does not require an AgentContext.
+     *
+     * C460/AC-1/AC-3: `type`/`scope`/`unusedDays`/`offset` added so the Portal Memory
+     * Tab can fetch the anchor (`type: 'anchor', scope: 'all'`, AC-1) and the stale/
+     * never-applied filter (`unusedDays`, AC-3) without a second bespoke endpoint —
+     * these already exist on GET /memories (C458/AC-9, F403/AC-6, B364), just not
+     * wired through this admin-UI method before.
+     */
+    listByFilter(filter: {
+        agentId?: string;
+        project?: string;
+        limit?: number;
+        type?: MemoryTypeReadable;
+        scope?: MemoryScope;
+        unusedDays?: number;
+        offset?: number;
+    }): Promise<Memory[]>;
+    /**
+     * List memories filtered by agentId and/or project, with pagination metadata (total
+     * count) — C814: powers the lightweight Memory-tab badge count, mirrors
+     * AdminDocumentsClient.listPaged (`limit: 1` + read `meta.total`, no full payload).
+     */
+    listPaged(filter: {
+        agentId?: string;
+        project?: string;
+        limit?: number;
+        type?: MemoryTypeReadable;
+        scope?: MemoryScope;
+    }): Promise<MemoryListResult>;
+    /** C460/AC-4/AC-5: duplicate clusters + contradiction pairs for the Portal Memory Tab. */
+    clusters(filter: {
+        agentId: string;
+        project?: string;
+    }): Promise<DuplicateClusterResult>;
+}
+//# sourceMappingURL=memories.client.d.ts.map

package/dist/clients/admin/memories.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.client.d.ts","sourceRoot":"","sources":["../../../src/clients/admin/memories.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD;AAED,qBAAa,mBAAmB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEvC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUnF,IAAI,CACN,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,UAAU,CAAA;QACjB,KAAK,CAAC,EAAE,WAAW,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,eAAe,CAAC,EAAE,MAAM,CAAA;KAC3B,GACF,OAAO,CAAC,MAAM,EAAE,CAAC;IAcd,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWjE,WAAW,CACb,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,OAAO,CAAC;IAab,cAAc,CAChB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5C,OAAO,CAAC,MAAM,EAAE,CAAC;IASpB;;;;;;;;;OASG;IACG,YAAY,CAAC,MAAM,EAAE;QACvB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,kBAAkB,CAAA;QACzB,KAAK,CAAC,EAAE,WAAW,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;KAClB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYrB;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE;QACpB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,kBAAkB,CAAA;QACzB,KAAK,CAAC,EAAE,WAAW,CAAA;KACtB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAU7B,0FAA0F;IACpF,QAAQ,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAMjG"}

package/dist/clients/admin/memories.client.js

@@ -0,0 +1,126 @@
+export class AdminMemoriesClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async upsert(context, input) {
+        return this.http.post('/memories', {
+            ...input,
+            agentId: context.agentId,
+            project: context.project,
+        });
+    }
+    async findForSession(context, opts) {
+        const params = new URLSearchParams();
+        params.set('agentId', context.agentId);
+        // F428: org-scoped agent context has no single project — '' matches the pre-F428
+        // behavior for a project-less caller (out of F428's scope to redesign).
+        params.set('project', context.project ?? '');
+        if (opts?.limit != null)
+            params.set('limit', String(opts.limit));
+        return this.http.get(`/memories/for-session?${params.toString()}`);
+    }
+    async list(context, filter) {
+        const params = new URLSearchParams();
+        params.set('agentId', context.agentId);
+        // F428: org-scoped agent context has no single project — '' matches the pre-F428
+        // behavior for a project-less caller (out of F428's scope to redesign).
+        params.set('project', context.project ?? '');
+        if (filter?.type)
+            params.set('type', filter.type);
+        if (filter?.scope)
+            params.set('scope', filter.scope);
+        if (filter?.limit != null)
+            params.set('limit', String(filter.limit));
+        if (filter?.staleUnusedDays != null)
+            params.set('staleUnusedDays', String(filter.staleUnusedDays));
+        return this.http.get(`/memories?${params.toString()}`);
+    }
+    async delete(context, memoryId) {
+        try {
+            await this.http.delete(`/memories/${encodeURIComponent(memoryId)}?agentId=${encodeURIComponent(context.agentId)}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async deleteByKey(context, key, opts) {
+        const params = new URLSearchParams();
+        params.set('agentId', context.agentId);
+        params.set('key', key);
+        if (!opts?.global && context.project)
+            params.set('project', context.project);
+        try {
+            await this.http.delete(`/memories/by-key?${params.toString()}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async searchByVector(context, embedding, opts) {
+        return this.http.post('/memories/search-by-vector', {
+            agentId: context.agentId,
+            embedding,
+            project: opts?.global ? null : context.project || null,
+            limit: opts?.limit,
+        });
+    }
+    /**
+     * List memories filtered by agentId and/or project — for admin UI use.
+     * Unlike `list()`, this does not require an AgentContext.
+     *
+     * C460/AC-1/AC-3: `type`/`scope`/`unusedDays`/`offset` added so the Portal Memory
+     * Tab can fetch the anchor (`type: 'anchor', scope: 'all'`, AC-1) and the stale/
+     * never-applied filter (`unusedDays`, AC-3) without a second bespoke endpoint —
+     * these already exist on GET /memories (C458/AC-9, F403/AC-6, B364), just not
+     * wired through this admin-UI method before.
+     */
+    async listByFilter(filter) {
+        const params = new URLSearchParams();
+        if (filter.agentId)
+            params.set('agent_id', filter.agentId);
+        if (filter.project)
+            params.set('project', filter.project);
+        if (filter.limit != null)
+            params.set('limit', String(filter.limit));
+        if (filter.type)
+            params.set('type', filter.type);
+        if (filter.scope)
+            params.set('scope', filter.scope);
+        if (filter.unusedDays != null)
+            params.set('unusedDays', String(filter.unusedDays));
+        if (filter.offset != null)
+            params.set('offset', String(filter.offset));
+        return this.http.get(`/memories?${params.toString()}`);
+    }
+    /**
+     * List memories filtered by agentId and/or project, with pagination metadata (total
+     * count) — C814: powers the lightweight Memory-tab badge count, mirrors
+     * AdminDocumentsClient.listPaged (`limit: 1` + read `meta.total`, no full payload).
+     */
+    async listPaged(filter) {
+        const params = new URLSearchParams();
+        if (filter.agentId)
+            params.set('agent_id', filter.agentId);
+        if (filter.project)
+            params.set('project', filter.project);
+        if (filter.limit != null)
+            params.set('limit', String(filter.limit));
+        if (filter.type)
+            params.set('type', filter.type);
+        if (filter.scope)
+            params.set('scope', filter.scope);
+        return this.http.getEnvelope(`/memories?${params.toString()}`);
+    }
+    /** C460/AC-4/AC-5: duplicate clusters + contradiction pairs for the Portal Memory Tab. */
+    async clusters(filter) {
+        const params = new URLSearchParams();
+        params.set('agentId', filter.agentId);
+        if (filter.project)
+            params.set('project', filter.project);
+        return this.http.get(`/memories/clusters?${params.toString()}`);
+    }
+}
+//# sourceMappingURL=memories.client.js.map

package/dist/clients/admin/memories.client.js.map

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

package/dist/clients/admin/metrics.client.d.ts

@@ -0,0 +1,80 @@
+import type { HttpClient } from '../../transport/http-client.js';
+/**
+ * AdminMetricsClient — C823.
+ *
+ * Typed SDK access to F515's aggregated request-metering read API
+ * (`GET /api/v1/metrics/requests`) and C796's aggregated campaign-analytics read API
+ * (`GET /api/v1/metrics/campaigns`) — both mounted on `userV1` behind
+ * `requireProjectOwnershipQuery('project')` (services/api/src/app/routes.ts), same
+ * auth/ownership posture as `AdminUsageClient`. `campaigns()` deliberately shares this
+ * client (not a separate `campaign-events.client.ts`) — B762/AC-2 asked for it to match
+ * `requests()`'s shape/conventions exactly, and both routes share the identical
+ * user-JWT + project-ownership guard family (unlike the anonymous ingest endpoint,
+ * `POST /api/v1/campaign-events`, which is Ops-SDK-reachable instead — see
+ * `clients/ops/campaign-events-ops.client.ts`).
+ */
+export declare const METRICS_REQUESTS_GROUP_BY: readonly ["routeTemplate", "path", "method", "statusClass", "actorId"];
+export type MetricsRequestsGroupBy = (typeof METRICS_REQUESTS_GROUP_BY)[number];
+export interface MetricsRequestsFilter {
+    project?: string;
+    org?: string;
+    /** ISO-8601 timestamp. */
+    since: string;
+    /** ISO-8601 timestamp. */
+    until: string;
+    groupBy: MetricsRequestsGroupBy;
+}
+export interface MetricsRow {
+    key: string;
+    requestCount: number;
+    errorCount: number;
+    avgDurationMs: number;
+    /** F478/AC-17 convention, reused verbatim: 'complete' = reconciled/exact,
+     *  'inflated' = live-flush-only/provisional — see `meta.reconciledThrough`. */
+    coverage: 'complete' | 'inflated';
+}
+export interface MetricsRequestsResult {
+    data: MetricsRow[];
+    meta: {
+        reconciledThrough: string | null;
+    };
+}
+export declare const CAMPAIGN_METRICS_GROUP_BY: readonly ["campaign", "channel", "referrerDomain", "eventType"];
+export type CampaignMetricsGroupBy = (typeof CAMPAIGN_METRICS_GROUP_BY)[number];
+export declare const CAMPAIGN_METRICS_EVENT_TYPES: readonly ["pageview", "lead_conversion"];
+export type CampaignMetricsEventType = (typeof CAMPAIGN_METRICS_EVENT_TYPES)[number];
+export interface CampaignMetricsFilter {
+    project: string;
+    /** `YYYY-MM-DD` (day-grain, per `campaign_metrics_rollup`'s `bucket_start`). */
+    since: string;
+    /** `YYYY-MM-DD`. */
+    until: string;
+    groupBy: CampaignMetricsGroupBy;
+    /** C837: optional filter — split any `groupBy` (e.g. `campaign`) into a
+     *  pageviews-vs-leads breakdown per key via two filtered calls, instead of only
+     *  globally via `groupBy=eventType`. */
+    eventType?: CampaignMetricsEventType;
+}
+export interface CampaignMetricsRow {
+    key: string;
+    count: number;
+}
+export declare class AdminMetricsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * GET /api/v1/metrics/requests — F515/AC-13. Returns the `{ data, meta }` envelope
+     * as-is (not auto-unwrapped) — `meta.reconciledThrough` is load-bearing (AC-9/AC-10:
+     * a caller computing anything billing-relevant MUST filter to `coverage: 'complete'`
+     * rows and/or windows before the watermark), so this uses `getEnvelope` rather than
+     * `get` (which would silently drop `meta`).
+     */
+    requests(filter: MetricsRequestsFilter): Promise<MetricsRequestsResult>;
+    /**
+     * GET /api/v1/metrics/campaigns — C796/AC-4. `{ data: CampaignMetricsRow[] }` only
+     * (no `meta`/watermark — campaign analytics has no reconciliation job, § C796
+     * Architecture Simplification) — `get` unwraps to the bare row array.
+     */
+    campaigns(filter: CampaignMetricsFilter): Promise<CampaignMetricsRow[]>;
+}
+//# sourceMappingURL=metrics.client.d.ts.map

package/dist/clients/admin/metrics.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.client.d.ts","sourceRoot":"","sources":["../../../src/clients/admin/metrics.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE;;;;;;;;;;;;;GAaG;AAKH,eAAO,MAAM,yBAAyB,wEAM5B,CAAA;AACV,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/E,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,sBAAsB,CAAA;CAClC;AAED,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB;mFAC+E;IAC/E,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAA;CACpC;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,IAAI,EAAE;QAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAC7C;AAID,eAAO,MAAM,yBAAyB,iEAK5B,CAAA;AACV,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/E,eAAO,MAAM,4BAA4B,0CAA2C,CAAA;AACpF,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpF,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,sBAAsB,CAAA;IAC/B;;4CAEwC;IACxC,SAAS,CAAC,EAAE,wBAAwB,CAAA;CACvC;AAED,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,kBAAkB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAY7E;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAShF"}

package/dist/clients/admin/metrics.client.js

@@ -0,0 +1,71 @@
+/**
+ * AdminMetricsClient — C823.
+ *
+ * Typed SDK access to F515's aggregated request-metering read API
+ * (`GET /api/v1/metrics/requests`) and C796's aggregated campaign-analytics read API
+ * (`GET /api/v1/metrics/campaigns`) — both mounted on `userV1` behind
+ * `requireProjectOwnershipQuery('project')` (services/api/src/app/routes.ts), same
+ * auth/ownership posture as `AdminUsageClient`. `campaigns()` deliberately shares this
+ * client (not a separate `campaign-events.client.ts`) — B762/AC-2 asked for it to match
+ * `requests()`'s shape/conventions exactly, and both routes share the identical
+ * user-JWT + project-ownership guard family (unlike the anonymous ingest endpoint,
+ * `POST /api/v1/campaign-events`, which is Ops-SDK-reachable instead — see
+ * `clients/ops/campaign-events-ops.client.ts`).
+ */
+// ── GET /v1/metrics/requests (F515/AC-13) ───────────────────────────────────────
+// C838: 'path' added — F26's beacon-web per-page dashboard query.
+export const METRICS_REQUESTS_GROUP_BY = [
+    'routeTemplate',
+    'path',
+    'method',
+    'statusClass',
+    'actorId',
+];
+// ── GET /v1/metrics/campaigns (C796/AC-4) ───────────────────────────────────────
+export const CAMPAIGN_METRICS_GROUP_BY = [
+    'campaign',
+    'channel',
+    'referrerDomain',
+    'eventType',
+];
+export const CAMPAIGN_METRICS_EVENT_TYPES = ['pageview', 'lead_conversion'];
+export class AdminMetricsClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * GET /api/v1/metrics/requests — F515/AC-13. Returns the `{ data, meta }` envelope
+     * as-is (not auto-unwrapped) — `meta.reconciledThrough` is load-bearing (AC-9/AC-10:
+     * a caller computing anything billing-relevant MUST filter to `coverage: 'complete'`
+     * rows and/or windows before the watermark), so this uses `getEnvelope` rather than
+     * `get` (which would silently drop `meta`).
+     */
+    async requests(filter) {
+        const params = new URLSearchParams();
+        if (filter.project)
+            params.set('project', filter.project);
+        if (filter.org)
+            params.set('org', filter.org);
+        params.set('since', filter.since);
+        params.set('until', filter.until);
+        params.set('groupBy', filter.groupBy);
+        return this.http.getEnvelope(`/metrics/requests?${params.toString()}`);
+    }
+    /**
+     * GET /api/v1/metrics/campaigns — C796/AC-4. `{ data: CampaignMetricsRow[] }` only
+     * (no `meta`/watermark — campaign analytics has no reconciliation job, § C796
+     * Architecture Simplification) — `get` unwraps to the bare row array.
+     */
+    async campaigns(filter) {
+        const params = new URLSearchParams();
+        params.set('project', filter.project);
+        params.set('since', filter.since);
+        params.set('until', filter.until);
+        params.set('groupBy', filter.groupBy);
+        if (filter.eventType)
+            params.set('eventType', filter.eventType);
+        return this.http.get(`/metrics/campaigns?${params.toString()}`);
+    }
+}
+//# sourceMappingURL=metrics.client.js.map

package/dist/clients/admin/metrics.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.client.js","sourceRoot":"","sources":["../../../src/clients/admin/metrics.client.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,mFAAmF;AAEnF,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,eAAe;IACf,MAAM;IACN,QAAQ;IACR,aAAa;IACb,SAAS;CACH,CAAA;AA4BV,mFAAmF;AAEnF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,UAAU;IACV,SAAS;IACT,gBAAgB;IAChB,WAAW;CACL,CAAA;AAGV,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,UAAU,EAAE,iBAAiB,CAAU,CAAA;AAqBpF,MAAM,OAAO,kBAAkB;IACE;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA6B;QACxC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,IAAI,MAAM,CAAC,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CACxB,qBAAqB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAC3C,CAAA;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,MAA6B;QACzC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACrC,IAAI,MAAM,CAAC,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,sBAAsB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IACzF,CAAC;CACJ"}