@beacon-build/sdk 2.4.4 → 2.5.0

package/dist/clients/ops/documents-ops.client.js

@@ -0,0 +1,31 @@
+export class DocumentsOpsClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async upsert(input) {
+        const res = await this.api.post('/api/v1/documents/upsert', input);
+        return res.data;
+    }
+    async get(project, type, name) {
+        try {
+            const params = new URLSearchParams({ project, type, name });
+            const res = await this.api.get(`/api/v1/documents/get?${params.toString()}`);
+            return res.data;
+        }
+        catch {
+            return null;
+        }
+    }
+    async list(filter = {}) {
+        const params = new URLSearchParams();
+        if (filter.project)
+            params.set('project', filter.project);
+        if (filter.type)
+            params.set('type', filter.type);
+        const qs = params.toString();
+        const res = await this.api.get(`/api/v1/documents${qs ? `?${qs}` : ''}`);
+        return res.data;
+    }
+}
+//# sourceMappingURL=documents-ops.client.js.map

package/dist/clients/ops/documents-ops.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents-ops.client.js","sourceRoot":"","sources":["../../../src/clients/ops/documents-ops.client.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,kBAAkB;IACE;IAA7B,YAA6B,GAAiB;QAAjB,QAAG,GAAH,GAAG,CAAc;IAAG,CAAC;IAElD,KAAK,CAAC,MAAM,CAAC,KAA6B;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAqB,0BAA0B,EAAE,KAAK,CAAC,CAAA;QACtF,OAAO,GAAG,CAAC,IAAI,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,IAAY,EAAE,IAAY;QACjD,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAC1B,yBAAyB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAC/C,CAAA;YACD,OAAO,GAAG,CAAC,IAAI,CAAA;QACnB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAA;QACf,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA8C,EAAE;QACvD,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,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAC1B,oBAAoB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3C,CAAA;QACD,OAAO,GAAG,CAAC,IAAI,CAAA;IACnB,CAAC;CACJ"}

package/dist/clients/ops/github-credential-ops.client.d.ts

@@ -0,0 +1,29 @@
+import type { OpsApiClient } from '../../transport/ops-api-client.js';
+/**
+ * F526/AC-2/AC-3 — the SDK-side call to `services/api/src/routes/github-credential.ts`
+ * (`GET /v1/github-credential?seat=&owner=&repo=`). Consumed by `mcp/beacon`'s new
+ * `resolveCloudGithubCredential` (`packages/mcp-core/src/github/user-credential.ts`) — the
+ * cross-process credential-delivery seam a call site with no direct DB access needs to resolve
+ * the caller-attributed GitHub write credential. See that route's module doc for the full
+ * seat/fail-closed design.
+ */
+export declare class GithubCredentialOpsClient {
+    private readonly api;
+    constructor(api: OpsApiClient);
+    /**
+     * Returns `null` on ANY failure — no triggering human resolved for the seat, no available
+     * credential (fail-closed A), or a transport error. The caller decides what "no credential"
+     * means for its own call site (AC-4/AC-5: Cloud context + no credential = fail loud;
+     * `resolveCloudGithubCredential`'s own doc owns that decision, not this thin transport).
+     */
+    resolve(seat: string, ctx?: {
+        owner?: string;
+        repo?: string;
+    }): Promise<{
+        token: string;
+        tier: '1' | '2';
+        authorName?: string;
+        authorEmail?: string;
+    } | null>;
+}
+//# sourceMappingURL=github-credential-ops.client.d.ts.map

package/dist/clients/ops/github-credential-ops.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-credential-ops.client.d.ts","sourceRoot":"","sources":["../../../src/clients/ops/github-credential-ops.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAErE;;;;;;;GAOG;AACH,qBAAa,yBAAyB;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,YAAY;IAE9C;;;;;OAKG;IACG,OAAO,CACT,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5C,OAAO,CAAC;QACP,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,GAAG,GAAG,GAAG,CAAA;QACf,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,WAAW,CAAC,EAAE,MAAM,CAAA;KACvB,GAAG,IAAI,CAAC;CAWZ"}

package/dist/clients/ops/github-credential-ops.client.js

@@ -0,0 +1,32 @@
+/**
+ * F526/AC-2/AC-3 — the SDK-side call to `services/api/src/routes/github-credential.ts`
+ * (`GET /v1/github-credential?seat=&owner=&repo=`). Consumed by `mcp/beacon`'s new
+ * `resolveCloudGithubCredential` (`packages/mcp-core/src/github/user-credential.ts`) — the
+ * cross-process credential-delivery seam a call site with no direct DB access needs to resolve
+ * the caller-attributed GitHub write credential. See that route's module doc for the full
+ * seat/fail-closed design.
+ */
+export class GithubCredentialOpsClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+     * Returns `null` on ANY failure — no triggering human resolved for the seat, no available
+     * credential (fail-closed A), or a transport error. The caller decides what "no credential"
+     * means for its own call site (AC-4/AC-5: Cloud context + no credential = fail loud;
+     * `resolveCloudGithubCredential`'s own doc owns that decision, not this thin transport).
+     */
+    async resolve(seat, ctx = {}) {
+        const params = new URLSearchParams({ seat });
+        if (ctx.owner)
+            params.set('owner', ctx.owner);
+        if (ctx.repo)
+            params.set('repo', ctx.repo);
+        const res = await this.api
+            .get(`/api/v1/github-credential?${params.toString()}`)
+            .catch(() => null);
+        return res?.data ?? null;
+    }
+}
+//# sourceMappingURL=github-credential-ops.client.js.map

package/dist/clients/ops/github-credential-ops.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-credential-ops.client.js","sourceRoot":"","sources":["../../../src/clients/ops/github-credential-ops.client.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,yBAAyB;IACL;IAA7B,YAA6B,GAAiB;QAAjB,QAAG,GAAH,GAAG,CAAc;IAAG,CAAC;IAElD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CACT,IAAY,EACZ,MAAyC,EAAE;QAO3C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,IAAI,GAAG,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;QAC7C,IAAI,GAAG,CAAC,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG;aACrB,GAAG,CAED,6BAA6B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;aACnD,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACtB,OAAO,GAAG,EAAE,IAAI,IAAI,IAAI,CAAA;IAC5B,CAAC;CACJ"}

package/dist/clients/ops/leads-ops.client.d.ts

@@ -0,0 +1,36 @@
+import type { LeadDto, LeadIntent } from '@beacon-build/core';
+import type { OpsApiClient } from '../../transport/ops-api-client.js';
+/** AC-27/AC-28: `LeadsOpsClient` — create/list/get/update, mirrors `TasksOpsClient`'s
+ *  shape/registration exactly. Every method unwraps the `{ data }` envelope — never
+ *  returns the raw envelope object. */
+export interface CreateLeadOpsInput {
+    email: string;
+    source: string;
+    locale: string;
+    company?: string;
+    message?: string;
+    /** C737/AC-1: optional lead-source-intent tag. */
+    intent?: LeadIntent;
+}
+export interface UpdateLeadOpsFields {
+    email?: string;
+    status?: string;
+    company?: string;
+    message?: string;
+}
+export interface LeadListOpsFilter {
+    status?: string;
+    /** C737/AC-3: filters by `LEAD_INTENT_VALUES`. */
+    intent?: LeadIntent;
+    page?: number;
+    limit?: number;
+}
+export declare class LeadsOpsClient {
+    private readonly api;
+    constructor(api: OpsApiClient);
+    create(input: CreateLeadOpsInput): Promise<LeadDto>;
+    list(filter?: LeadListOpsFilter): Promise<LeadDto[]>;
+    get(id: string): Promise<LeadDto>;
+    update(id: string, fields: UpdateLeadOpsFields): Promise<LeadDto>;
+}
+//# sourceMappingURL=leads-ops.client.d.ts.map

package/dist/clients/ops/leads-ops.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leads-ops.client.d.ts","sourceRoot":"","sources":["../../../src/clients/ops/leads-ops.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAErE;;uCAEuC;AAEvC,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,UAAU,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,cAAc;IACX,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,YAAY;IAExC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnD,IAAI,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAWxD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAO1E"}

package/dist/clients/ops/leads-ops.client.js

@@ -0,0 +1,35 @@
+export class LeadsOpsClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async create(input) {
+        const res = await this.api.post('/api/v1/leads', input);
+        return res.data;
+    }
+    // AC-28: unwraps the `{ data }` envelope — same contract shape as
+    // `TasksOpsClient.list()` (returns the bare array, drops `meta`).
+    async list(filter = {}) {
+        const params = new URLSearchParams();
+        if (filter.status)
+            params.set('status', filter.status);
+        if (filter.intent)
+            params.set('intent', filter.intent);
+        if (filter.page != null)
+            params.set('page', String(filter.page));
+        if (filter.limit != null)
+            params.set('limit', String(filter.limit));
+        const qs = params.toString();
+        const res = await this.api.get(`/api/v1/leads${qs ? `?${qs}` : ''}`);
+        return res.data ?? [];
+    }
+    async get(id) {
+        const res = await this.api.get(`/api/v1/leads/${encodeURIComponent(id)}`);
+        return res.data;
+    }
+    async update(id, fields) {
+        const res = await this.api.patch(`/api/v1/leads/${encodeURIComponent(id)}`, fields);
+        return res.data;
+    }
+}
+//# sourceMappingURL=leads-ops.client.js.map

package/dist/clients/ops/leads-ops.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leads-ops.client.js","sourceRoot":"","sources":["../../../src/clients/ops/leads-ops.client.ts"],"names":[],"mappings":"AAgCA,MAAM,OAAO,cAAc;IACM;IAA7B,YAA6B,GAAiB;QAAjB,QAAG,GAAH,GAAG,CAAc;IAAG,CAAC;IAElD,KAAK,CAAC,MAAM,CAAC,KAAyB;QAClC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAoB,eAAe,EAAE,KAAK,CAAC,CAAA;QAC1E,OAAO,GAAG,CAAC,IAAI,CAAA;IACnB,CAAC;IAED,kEAAkE;IAClE,kEAAkE;IAClE,KAAK,CAAC,IAAI,CAAC,SAA4B,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QAChE,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACnE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAsB,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACzF,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAChB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAoB,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC5F,OAAO,GAAG,CAAC,IAAI,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA2B;QAChD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAC5B,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACzC,MAAM,CACT,CAAA;QACD,OAAO,GAAG,CAAC,IAAI,CAAA;IACnB,CAAC;CACJ"}

package/dist/clients/ops/memories-ops.client.d.ts

@@ -0,0 +1,25 @@
+import type { AgentContext, Memory, UpsertMemoryInput, MemoryType, MemoryScope } from '@beacon-build/core';
+import type { OpsApiClient } from '../../transport/ops-api-client.js';
+export declare class MemoriesOpsClient {
+    private readonly api;
+    constructor(api: OpsApiClient);
+    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[]>;
+}
+//# sourceMappingURL=memories-ops.client.d.ts.map

package/dist/clients/ops/memories-ops.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories-ops.client.d.ts","sourceRoot":"","sources":["../../../src/clients/ops/memories-ops.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,WAAW,EACd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAErE,qBAAa,iBAAiB;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,YAAY;IAExC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IASxE,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAanF,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;IAed,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;CASvB"}

package/dist/clients/ops/memories-ops.client.js

@@ -0,0 +1,75 @@
+export class MemoriesOpsClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async upsert(context, input) {
+        const res = await this.api.post('/api/v1/memories', {
+            ...input,
+            agentId: context.agentId,
+            project: context.project,
+        });
+        return res.data;
+    }
+    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));
+        const res = await this.api.get(`/api/v1/memories/for-session?${params.toString()}`);
+        return res.data;
+    }
+    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));
+        const res = await this.api.get(`/api/v1/memories?${params.toString()}`);
+        return res.data;
+    }
+    async delete(context, memoryId) {
+        try {
+            await this.api.delete(`/api/v1/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.api.delete(`/api/v1/memories/by-key?${params.toString()}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async searchByVector(context, embedding, opts) {
+        const res = await this.api.post('/api/v1/memories/search-by-vector', {
+            agentId: context.agentId,
+            embedding,
+            project: opts?.global ? null : context.project || null,
+            limit: opts?.limit,
+        });
+        return res.data;
+    }
+}
+//# sourceMappingURL=memories-ops.client.js.map

package/dist/clients/ops/memories-ops.client.js.map

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

package/dist/clients/ops/metrics-ops.client.d.ts

@@ -0,0 +1,38 @@
+import type { OpsApiClient } from '../../transport/ops-api-client.js';
+/**
+ * MetricsOpsClient — C823.
+ *
+ * Typed SDK access to F515/AC-6's on-demand request-correlation read API
+ * (`GET /api/v1/metrics/correlation`) — Ops-gated (Argus system-JWT, org-less
+ * admin/vendor JWT, or the `OPS_API_KEY` dual-accept safety net; the SAME
+ * `honoOpsAuthGuard` mount `/v1/ops/*` uses, not a new role —
+ * `services/api/src/app/routes-ops-mounts.ts`). Not reachable via `AdminSdk`'s
+ * User-JWT-only `HttpClient` for a non-admin/vendor human caller.
+ */
+export interface MetricsCorrelationFilter {
+    /** Authenticated `userId` to correlate — required unless `requestId` is given (AC-6:
+     *  correlation has no anonymous concept, at least one target is mandatory). */
+    userId?: string;
+    requestId?: string;
+    /** ISO-8601. Defaults server-side to `until - 24h` when omitted. */
+    since?: string;
+    /** ISO-8601. Defaults server-side to `now` when omitted. */
+    until?: string;
+}
+export interface CorrelatedRequestRecord {
+    requestId: string;
+    method: string;
+    path: string;
+    status: number;
+    durationMs: number;
+    /** ISO-8601. */
+    time: string;
+}
+export declare class MetricsOpsClient {
+    private readonly api;
+    constructor(api: OpsApiClient);
+    /** GET /api/v1/metrics/correlation — F515/AC-6/AC-7. Unwraps the `{ data }` envelope
+     *  (no `meta` on this response — see `services/api/src/schemas/metrics.ts`). */
+    correlation(filter: MetricsCorrelationFilter): Promise<CorrelatedRequestRecord[]>;
+}
+//# sourceMappingURL=metrics-ops.client.d.ts.map

package/dist/clients/ops/metrics-ops.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-ops.client.d.ts","sourceRoot":"","sources":["../../../src/clients/ops/metrics-ops.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAErE;;;;;;;;;GASG;AAEH,MAAM,WAAW,wBAAwB;IACrC;mFAC+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,gBAAgB;IACb,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,YAAY;IAE9C;oFACgF;IAC1E,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAY1F"}

package/dist/clients/ops/metrics-ops.client.js

@@ -0,0 +1,23 @@
+export class MetricsOpsClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    /** GET /api/v1/metrics/correlation — F515/AC-6/AC-7. Unwraps the `{ data }` envelope
+     *  (no `meta` on this response — see `services/api/src/schemas/metrics.ts`). */
+    async correlation(filter) {
+        const params = new URLSearchParams();
+        if (filter.userId)
+            params.set('userId', filter.userId);
+        if (filter.requestId)
+            params.set('requestId', filter.requestId);
+        if (filter.since)
+            params.set('since', filter.since);
+        if (filter.until)
+            params.set('until', filter.until);
+        const qs = params.toString();
+        const res = await this.api.get(`/api/v1/metrics/correlation${qs ? `?${qs}` : ''}`);
+        return res.data ?? [];
+    }
+}
+//# sourceMappingURL=metrics-ops.client.js.map

package/dist/clients/ops/metrics-ops.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-ops.client.js","sourceRoot":"","sources":["../../../src/clients/ops/metrics-ops.client.ts"],"names":[],"mappings":"AAkCA,MAAM,OAAO,gBAAgB;IACI;IAA7B,YAA6B,GAAiB;QAAjB,QAAG,GAAH,GAAG,CAAc;IAAG,CAAC;IAElD;oFACgF;IAChF,KAAK,CAAC,WAAW,CAAC,MAAgC;QAC9C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,MAAM,CAAC,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;QAC/D,IAAI,MAAM,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACnD,IAAI,MAAM,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACnD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAC1B,8BAA8B,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACrD,CAAA;QACD,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IACzB,CAAC;CACJ"}

package/dist/clients/ops/ops-db.client.d.ts

@@ -0,0 +1,49 @@
+import type { OpsApiClient } from '../../transport/ops-api-client.js';
+import { type SseStreamHandler, type SseStreamResult } from '../../transport/sse-client.js';
+export interface DbMigrateOptions {
+    handler: SseStreamHandler;
+}
+export interface DbSeedOptions {
+    handler: SseStreamHandler;
+    mode?: 'full' | 'production' | 'auto';
+}
+export interface DbResetOptions {
+    handler: SseStreamHandler;
+    confirm: true;
+}
+export declare class OpsDbClient {
+    private readonly api;
+    private readonly apiKey;
+    private sse;
+    constructor(api: OpsApiClient, apiKey: string);
+    stats(): Promise<Record<string, unknown>>;
+    /**
+     * Run a read-only SQL query (SELECT/WITH/EXPLAIN) with positional params.
+     * Backs the remote path of project-db's db_query/tables/schema/count/sample (F327).
+     */
+    query(sql: string, params?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        truncated: boolean;
+    }>;
+    /**
+     * Run a write statement (INSERT/UPDATE/DELETE) server-side with positional params.
+     * Backs the remote path of project-db's db_execute (F327 AC-2). The server enforces the
+     * safety model: SELECT is rejected, DDL is prod-guarded, and DML against prod/staging
+     * requires `confirm=true`. Returns the number of affected rows.
+     */
+    execute(sql: string, params?: unknown[], opts?: {
+        confirm?: boolean;
+        allowDenylistedTable?: boolean;
+    }): Promise<{
+        rowsAffected: number;
+    }>;
+    migrate(opts: DbMigrateOptions): SseStreamResult;
+    seed(opts: DbSeedOptions): SseStreamResult;
+    reset(opts: DbResetOptions): SseStreamResult;
+    migrations(): Promise<unknown[]>;
+    migrationStatus(): Promise<{
+        pending: number;
+        applied: number;
+    }>;
+}
+//# sourceMappingURL=ops-db.client.d.ts.map

package/dist/clients/ops/ops-db.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-db.client.d.ts","sourceRoot":"","sources":["../../../src/clients/ops/ops-db.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAEH,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACvB,MAAM,+BAA+B,CAAA;AAEtC,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,gBAAgB,CAAA;CAC5B;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,gBAAgB,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAAA;CACxC;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,gBAAgB,CAAA;IACzB,OAAO,EAAE,IAAI,CAAA;CAChB;AAED,qBAAa,WAAW;IAIhB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,GAAG,CAAW;gBAGD,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM;IAQ7B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/C;;;OAGG;IACG,KAAK,CACP,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAOnE;;;;;OAKG;IACG,OAAO,CACT,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,EAIlB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7D,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAapC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe;IAIhD,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe;IAM1C,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe;IAItC,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIhC,eAAe,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGzE"}

package/dist/clients/ops/ops-db.client.js

@@ -0,0 +1,62 @@
+import { SseClient, } from '../../transport/sse-client.js';
+export class OpsDbClient {
+    api;
+    apiKey;
+    sse;
+    constructor(api, apiKey) {
+        this.api = api;
+        this.apiKey = apiKey;
+        this.sse = new SseClient({
+            baseUrl: api.getBaseUrl(),
+            getAuthHeader: async () => `Bearer ${this.apiKey}`,
+        });
+    }
+    async stats() {
+        return this.api.get('/api/v1/ops/db/stats');
+    }
+    /**
+     * Run a read-only SQL query (SELECT/WITH/EXPLAIN) with positional params.
+     * Backs the remote path of project-db's db_query/tables/schema/count/sample (F327).
+     */
+    async query(sql, params) {
+        const res = await this.api.post('/api/v1/ops/db/query', { sql, params });
+        return res.data;
+    }
+    /**
+     * Run a write statement (INSERT/UPDATE/DELETE) server-side with positional params.
+     * Backs the remote path of project-db's db_execute (F327 AC-2). The server enforces the
+     * safety model: SELECT is rejected, DDL is prod-guarded, and DML against prod/staging
+     * requires `confirm=true`. Returns the number of affected rows.
+     */
+    async execute(sql, params, 
+    // F474/AC-4/M-6a: allowDenylistedTable is the explicit, logged break-glass override
+    // for the server-side table denylist — never a default, opt-in per call. Reserved for
+    // the AC-7 sanctioned cleanup path.
+    opts) {
+        const res = await this.api.post('/api/v1/ops/db/execute', {
+            sql,
+            params,
+            confirm: opts?.confirm,
+            allow_denylisted_table: opts?.allowDenylistedTable,
+        });
+        return res.data;
+    }
+    migrate(opts) {
+        return this.sse.stream('POST', '/ops/db/migrate', opts.handler);
+    }
+    seed(opts) {
+        return this.sse.stream('POST', '/ops/db/seed', opts.handler, {
+            mode: opts.mode ?? 'auto',
+        });
+    }
+    reset(opts) {
+        return this.sse.stream('POST', '/ops/db/reset', opts.handler, { confirm: true });
+    }
+    async migrations() {
+        return this.api.get('/api/v1/ops/db/migrations');
+    }
+    async migrationStatus() {
+        return this.api.get('/api/v1/ops/db/migration-status');
+    }
+}
+//# sourceMappingURL=ops-db.client.js.map

package/dist/clients/ops/ops-db.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-db.client.js","sourceRoot":"","sources":["../../../src/clients/ops/ops-db.client.ts"],"names":[],"mappings":"AACA,OAAO,EACH,SAAS,GAGZ,MAAM,+BAA+B,CAAA;AAgBtC,MAAM,OAAO,WAAW;IAIC;IACA;IAJb,GAAG,CAAW;IAEtB,YACqB,GAAiB,EACjB,MAAc;QADd,QAAG,GAAH,GAAG,CAAc;QACjB,WAAM,GAAN,MAAM,CAAQ;QAE/B,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC;YACrB,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE;YACzB,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE;SACrD,CAAC,CAAA;IACN,CAAC;IAED,KAAK,CAAC,KAAK;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAA0B,sBAAsB,CAAC,CAAA;IACxE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CACP,GAAW,EACX,MAAkB;QAElB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAE5B,sBAAsB,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3C,OAAO,GAAG,CAAC,IAAI,CAAA;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CACT,GAAW,EACX,MAAkB;IAClB,oFAAoF;IACpF,sFAAsF;IACtF,oCAAoC;IACpC,IAA4D;QAE5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAC3B,wBAAwB,EACxB;YACI,GAAG;YACH,MAAM;YACN,OAAO,EAAE,IAAI,EAAE,OAAO;YACtB,sBAAsB,EAAE,IAAI,EAAE,oBAAoB;SACrD,CACJ,CAAA;QACD,OAAO,GAAG,CAAC,IAAI,CAAA;IACnB,CAAC;IAED,OAAO,CAAC,IAAsB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IACnE,CAAC;IAED,IAAI,CAAC,IAAmB;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE;YACzD,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,MAAM;SAC5B,CAAC,CAAA;IACN,CAAC;IAED,KAAK,CAAC,IAAoB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IACpF,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAY,2BAA2B,CAAC,CAAA;IAC/D,CAAC;IAED,KAAK,CAAC,eAAe;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAuC,iCAAiC,CAAC,CAAA;IAChG,CAAC;CACJ"}

package/dist/clients/ops/ops-logs.client.d.ts

@@ -0,0 +1,63 @@
+import type { OpsApiClient } from '../../transport/ops-api-client.js';
+export interface LogSearchFilter {
+    service?: string;
+    level?: string;
+    keyword?: string;
+    after?: string;
+    before?: string;
+    limit?: number;
+}
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    message: string;
+    service?: string;
+    meta?: Record<string, unknown>;
+}
+export declare class OpsLogsClient {
+    private readonly api;
+    constructor(api: OpsApiClient);
+    search(filter?: LogSearchFilter): Promise<LogEntry[]>;
+    /**
+     * GET /ops/logs/server — tail the remote API host's own filesystem log for a server
+     * (F327 AC-4). Returns raw lines; the caller parses them with its own log parser, so the
+     * result is identical to the local-file path.
+     */
+    serverLogs(opts: {
+        service: string;
+        lines?: number;
+        grep?: string;
+    }): Promise<{
+        service: string;
+        lines: string[];
+        truncated: boolean;
+    }>;
+    /**
+     * GET /ops/logs/:slug/:env — F552 AC-5: the CONTROL-PLANE-addressed method for fetching a
+     * project's Northflank/local-dev logs, modeled on `OpsNorthflankClient.envStatus` (same
+     * "always-on management api, addressed by the target's own slug" shape). This is the route
+     * that actually reaches Northflank-hosted logs (F510) — unlike `serverLogs()` above, which
+     * only ever works against a bctl-wrapped host filesystem.
+     *
+     * `discover: true` (AC-1) asks the route to return ONLY `availableServices` (`lines: []`,
+     * `service: ''`) without touching Northflank/the local file at all — safe to call even when
+     * an actual log read would time out or error.
+     */
+    projectLogs(opts: {
+        slug: string;
+        env: string;
+        service?: string;
+        lines?: number;
+        minutes?: number;
+        search?: string;
+        regex?: boolean;
+        discover?: boolean;
+    }): Promise<ProjectLogsResult>;
+}
+export interface ProjectLogsResult {
+    lines: string[];
+    service: string;
+    availableServices: string[];
+    env: string;
+}
+//# sourceMappingURL=ops-logs.client.d.ts.map

package/dist/clients/ops/ops-logs.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-logs.client.d.ts","sourceRoot":"","sources":["../../../src/clients/ops/ops-logs.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAErE,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,YAAY;IAExC,MAAM,CAAC,MAAM,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAY/D;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAUrE;;;;;;;;;;OAUG;IACG,WAAW,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,OAAO,CAAA;KACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAajC;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;CACd"}

package/dist/clients/ops/ops-logs.client.js

@@ -0,0 +1,68 @@
+export class OpsLogsClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async search(filter = {}) {
+        const params = new URLSearchParams();
+        if (filter.service)
+            params.set('service', filter.service);
+        if (filter.level)
+            params.set('level', filter.level);
+        if (filter.keyword)
+            params.set('keyword', filter.keyword);
+        if (filter.after)
+            params.set('after', filter.after);
+        if (filter.before)
+            params.set('before', filter.before);
+        if (filter.limit != null)
+            params.set('limit', String(filter.limit));
+        const qs = params.toString();
+        return this.api.get(`/api/v1/ops/logs${qs ? `?${qs}` : ''}`);
+    }
+    /**
+     * GET /ops/logs/server — tail the remote API host's own filesystem log for a server
+     * (F327 AC-4). Returns raw lines; the caller parses them with its own log parser, so the
+     * result is identical to the local-file path.
+     */
+    async serverLogs(opts) {
+        const params = new URLSearchParams({ service: opts.service });
+        if (opts.lines != null)
+            params.set('lines', String(opts.lines));
+        if (opts.grep)
+            params.set('grep', opts.grep);
+        const res = await this.api.get(`/api/v1/ops/logs/server?${params.toString()}`);
+        return res.data;
+    }
+    /**
+     * GET /ops/logs/:slug/:env — F552 AC-5: the CONTROL-PLANE-addressed method for fetching a
+     * project's Northflank/local-dev logs, modeled on `OpsNorthflankClient.envStatus` (same
+     * "always-on management api, addressed by the target's own slug" shape). This is the route
+     * that actually reaches Northflank-hosted logs (F510) — unlike `serverLogs()` above, which
+     * only ever works against a bctl-wrapped host filesystem.
+     *
+     * `discover: true` (AC-1) asks the route to return ONLY `availableServices` (`lines: []`,
+     * `service: ''`) without touching Northflank/the local file at all — safe to call even when
+     * an actual log read would time out or error.
+     */
+    async projectLogs(opts) {
+        const params = new URLSearchParams();
+        if (opts.service)
+            params.set('service', opts.service);
+        if (opts.lines != null)
+            params.set('lines', String(opts.lines));
+        if (opts.minutes != null)
+            params.set('minutes', String(opts.minutes));
+        if (opts.search)
+            params.set('search', opts.search);
+        if (opts.regex)
+            params.set('regex', 'true');
+        if (opts.discover)
+            params.set('discover', 'true');
+        const qs = params.toString();
+        const path = `/api/v1/ops/logs/${encodeURIComponent(opts.slug)}/${encodeURIComponent(opts.env)}`;
+        const res = await this.api.get(qs ? `${path}?${qs}` : path);
+        return res.data;
+    }
+}
+//# sourceMappingURL=ops-logs.client.js.map