@beacon-build/sdk 3.11.0 → 3.13.0

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # @beacon-build/sdk Changelog
 
+## 3.13.0
+
+### Minor Changes
+
+- 8c70441: F770 (F640 AC-13 to AC-15): the onboarding wizard can reuse what exists, always as a click. New GET /api/v1/onboarding/reuse (SDK onboarding.getReuse) returns the active main-agent profiles of the projects in reach and, for an existing organisation, its stack / repo-owner presets and domain palette (derived from its visible projects and agents, null when none is visible, no schema). Step 3 offers a template that pre-fills character, roles and domains (not alias, avatar, address); step 2 offers the org stacks and repo owners; step 3 adds the org domains. No avatar is ever reused - a new agent never inherits another agent's image (F772). The provisioning request is unchanged.
+
+### Patch Changes
+
+- Updated dependencies [28ef67f]
+- Updated dependencies [acdf22b]
+- Updated dependencies [d303846]
+- Updated dependencies [1fc4231]
+- Updated dependencies [f1e22cf]
+- Updated dependencies [393482a]
+- Updated dependencies [8c70441]
+- Updated dependencies [ce5d5d3]
+- Updated dependencies [66609ac]
+- Updated dependencies [597ec7d]
+- Updated dependencies [53a8224]
+- Updated dependencies [d1f490f]
+- Updated dependencies [c2d5a93]
+- Updated dependencies [2999ff4]
+- Updated dependencies [aefd7cc]
+- Updated dependencies [b82bec7]
+- Updated dependencies [b61b907]
+- Updated dependencies [f975b56]
+- Updated dependencies [c340d3a]
+- Updated dependencies [3e306df]
+- Updated dependencies [e62fa55]
+- Updated dependencies [5931277]
+- Updated dependencies [002763c]
+    - @beacon-build/core@3.13.0
+
+## 3.12.0
+
+### Minor Changes
+
+- 8304f94: F741: KnowledgeClient review methods (reviewQueue, comments, approval rules), graph_review_queue and graph_comment tools, graph_transition with expected_revision; approve-drafts requires prRef.
+- 873ea43: F742: graph_context, the kg-index-reconcile job (stable-id backfill, per-project entry), MCP/SDK/API surfaces; graph_patch keeps the open draft's version and counts edits in revision (new REVISION_CONFLICT); graph_create assigns the R18 stable id; hybrid search is bounded for the p95 budget.
+
+### Patch Changes
+
+- f110d4b: B1290 security: the probe proxy is ops-authenticated with a path allowlist and a credential-free /v1/probe-health liveness route; the ops credential is bound to the deployment project (static key opt-in, DEPLOYMENT_PROJECT_SLUG mandatory on deployed runtimes, mainAgent mint scoped); fail-closed agent-control, enforce-flag (never off), billing and GitHub-author gates; required config stops the boot; OPS_API_KEYS has no legacy fallback; metrics-log-source requires its project slug.
+- 80356c8: F739 review fixes: cut-over table lock + re-count, stale running takeover, flag writes in the project repository, one migratedAt validity rule, approval policy purge on project delete, SDK testbed registration
+- d0b2f67: C1159: close the three bypasses around STDD receipts. git_pr_merge confirm_without_skill is a human-owner waiver decided and audited by the platform (new POST/GET /api/v1/pr-merge-waivers, pr_merge_waivers table; an agent credential gets 403 MERGE_WAIVER_HUMAN_ONLY and nothing is merged); task_complete on a task with a branch needs a completed stdd/implement-spec (stdd/fix-bug) receipt unless it runs inside the stdd/pr-merge that covers the task (422 RECEIPT_REQUIRED); a Main Protection Guard check fails loud when main lacks pull request + CI Result + no force push + no deletion. C1121: pr_tasks_complete completes the caller's own tasks without the on-behalf bypass, task_complete from claimed/in_progress names the concrete next steps, the finance integrator Martin carries release-manager (seed + named data migration).
+- 2d57d81: B1307: test-only kg perf-gate (F742 AC-34 Gate 2): ops route, worker job, shared reference-dataset generator, beacon-cli kg perf-gate
+- 3363d0e: F773: read-only list of all agent controller bindings of one project (GET /v1/agent-controllers?project=, SDK listForProject, agent_controller_list project param)
+- Updated dependencies [e5dfb98]
+- Updated dependencies [66956a4]
+- Updated dependencies [af5246d]
+- Updated dependencies [3416ea6]
+- Updated dependencies [80356c8]
+- Updated dependencies [d0b2f67]
+- Updated dependencies [029e4f7]
+- Updated dependencies [3363d0e]
+- Updated dependencies [ffe8edb]
+- Updated dependencies [2b44d5d]
+- Updated dependencies [4507c02]
+- Updated dependencies [6d858f2]
+    - @beacon-build/core@3.12.0
+
 ## 3.11.0
 
 ### Minor Changes

package/dist/clients/agent/agent-controller.client.d.ts

@@ -56,6 +56,11 @@ export declare class AgentControllerClient {
     constructor(http: HttpClient);
     grant(agentId: string, principalId: string): Promise<AgentControllerEntryDto>;
     list(agentId: string): Promise<AgentControllerEntryDto[]>;
+    /**
+     * F773: every (agent, human) binding of ONE project — GET /agent-controllers?project=<slug>,
+     * gated by project READ authority (not `mayManageAgentBindings`), identity-enriched per row.
+     */
+    listForProject(project: string): Promise<AgentControllerEntryDto[]>;
     /**
      * F483/AC-5/AC-8: the per-AGENT list, identity-enriched, PLUS the optional config-validity
      * marker — reads the `meta` sibling `list()`'s plain `http.get` (which unwraps to `data`

package/dist/clients/agent/agent-controller.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-controller.client.d.ts","sourceRoot":"","sources":["../../../src/clients/agent/agent-controller.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAA;CACtD;AAED,+FAA+F;AAC/F,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,2BAA2B;IACxC;;;;;;;;;OASG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAA;CACxC;AAED;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAClB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAO7E,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMzD;;;;OAIG;IACG,gBAAgB,CAClB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;QAAC,iBAAiB,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAQ5F;gEAC4D;IAC5D,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMnE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAQ3F"}
+{"version":3,"file":"agent-controller.client.d.ts","sourceRoot":"","sources":["../../../src/clients/agent/agent-controller.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAA;CACtD;AAED,+FAA+F;AAC/F,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,2BAA2B;IACxC;;;;;;;;;OASG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAA;CACxC;AAED;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAClB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAO7E,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMzD;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMnE;;;;OAIG;IACG,gBAAgB,CAClB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;QAAC,iBAAiB,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAQ5F;gEAC4D;IAC5D,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMnE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAQ3F"}

package/dist/clients/agent/agent-controller.client.js

@@ -19,6 +19,13 @@ export class AgentControllerClient {
     list(agentId) {
         return this.http.get(`/agent-controllers/${encodeURIComponent(agentId)}`);
     }
+    /**
+     * F773: every (agent, human) binding of ONE project — GET /agent-controllers?project=<slug>,
+     * gated by project READ authority (not `mayManageAgentBindings`), identity-enriched per row.
+     */
+    listForProject(project) {
+        return this.http.get(`/agent-controllers?project=${encodeURIComponent(project)}`);
+    }
     /**
      * F483/AC-5/AC-8: the per-AGENT list, identity-enriched, PLUS the optional config-validity
      * marker — reads the `meta` sibling `list()`'s plain `http.get` (which unwraps to `data`

package/dist/clients/agent/agent-controller.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-controller.client.js","sourceRoot":"","sources":["../../../src/clients/agent/agent-controller.client.ts"],"names":[],"mappings":"AAgDA;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAqB;IACV;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,KAAK,CAAC,OAAe,EAAE,WAAmB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACjB,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,EACnD,EAAE,WAAW,EAAE,CAClB,CAAA;IACL,CAAC;IAED,IAAI,CAAC,OAAe;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAChB,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CACtD,CAAA;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAClB,OAAe;QAEf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAGrC,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACvD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAA;IAClF,CAAC;IAED;gEAC4D;IAC5D,gBAAgB,CAAC,WAAmB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAChB,UAAU,kBAAkB,CAAC,WAAW,CAAC,oBAAoB,CAChE,CAAA;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,WAAmB;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,IAAI,IAAI,CAAA;QACxE,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAClB,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,CACzF,CAAA;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,EAAE,CAAA;IAC7C,CAAC;CACJ"}
+{"version":3,"file":"agent-controller.client.js","sourceRoot":"","sources":["../../../src/clients/agent/agent-controller.client.ts"],"names":[],"mappings":"AAgDA;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAqB;IACV;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,KAAK,CAAC,OAAe,EAAE,WAAmB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACjB,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,EACnD,EAAE,WAAW,EAAE,CAClB,CAAA;IACL,CAAC;IAED,IAAI,CAAC,OAAe;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAChB,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CACtD,CAAA;IACL,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAChB,8BAA8B,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAC9D,CAAA;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAClB,OAAe;QAEf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAGrC,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACvD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAA;IAClF,CAAC;IAED;gEAC4D;IAC5D,gBAAgB,CAAC,WAAmB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAChB,UAAU,kBAAkB,CAAC,WAAW,CAAC,oBAAoB,CAChE,CAAA;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,WAAmB;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,IAAI,IAAI,CAAA;QACxE,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAClB,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,CACzF,CAAA;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,EAAE,CAAA;IAC7C,CAAC;CACJ"}

package/dist/clients/agent/usage.client.d.ts

@@ -0,0 +1,113 @@
+/**
+ * F779 - token telemetry + quota-sample push (`sdk.usage.*`). Thin client over
+ * `/api/v1/usage/telemetry/*` and `POST /api/v1/usage/quota/samples`: agents and the MCP never use
+ * a raw fetch for these. Visibility is enforced server-side (vendor admins, the project owner, an
+ * agent only its own runs; quota samples / burn-rate: the account owner), so a 403 is a normal
+ * answer, not a bug. `http.get` unwraps the `{ data }` envelope.
+ */
+import type { HttpClient } from '../../transport/http-client.js';
+export type TelemetryBasis = 'exact' | 'estimated';
+export interface TelemetryRange {
+    /** ISO instants, required; the range is limited to 31 days server-side. */
+    from: string;
+    to: string;
+    project?: string;
+    role?: string;
+}
+export interface TelemetryTokenTotals {
+    input: number;
+    cacheRead: number;
+    cacheWrite: number;
+    output: number;
+}
+export interface TelemetryToolRow {
+    tool: string;
+    calls: number;
+    errors: number;
+    avgDurationMs: number | null;
+    resultBytes: number | null;
+    resultTokensEst: number | null;
+    turnCost: TelemetryTokenTotals;
+    exactShare: number;
+    basis: TelemetryBasis;
+}
+export interface TelemetryRunReport {
+    run: {
+        id: string;
+        agentType: string | null;
+        client: string | null;
+        modelRole: string;
+        turns: number;
+        tokens: TelemetryTokenTotals;
+        basis: TelemetryBasis;
+    };
+    tools: TelemetryToolRow[];
+}
+export interface TelemetryList<T = Record<string, unknown>> {
+    rows: T[];
+    coverage: {
+        byClient: Array<{
+            client: string;
+            turns: number;
+            coverageShare: number;
+        }>;
+    };
+    basis: TelemetryBasis;
+}
+export interface BurnRateWindow {
+    window: 'five_hour' | 'seven_day';
+    usedPercent: number | null;
+    resetsAt: string | null;
+    /** A PROJECTION of provider-reported values (never a reported figure); null when unknown. */
+    projectedAtReset: number | null;
+    state: 'ok' | 'warning' | 'critical' | 'unknown';
+    reason?: string;
+    samples: number;
+    spanMin: number;
+    slopePerHour: number | null;
+}
+export interface BurnRateResult {
+    account: string;
+    basis: 'projected';
+    windows: BurnRateWindow[];
+}
+export interface QuotaSamplePush {
+    /** `<provider>:user:<userId>` of the caller's own account. */
+    account: string;
+    window: 'five_hour' | 'seven_day';
+    usedPercent: number;
+    resetsAt: string | null;
+    sampledAt: string;
+}
+export declare class UsageTelemetryClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    run(id: string): Promise<TelemetryRunReport>;
+    tasks(range: TelemetryRange): Promise<TelemetryList>;
+    tools(range: TelemetryRange): Promise<TelemetryList<TelemetryToolRow>>;
+    polls(range: TelemetryRange): Promise<TelemetryList>;
+    baseload(range: TelemetryRange): Promise<TelemetryList>;
+    handbacks(range: TelemetryRange): Promise<TelemetryList>;
+    burnrate(account: string): Promise<BurnRateResult>;
+}
+/** `sdk.usage` of the Agent SDK. */
+export declare class AgentUsageClient {
+    private readonly http;
+    readonly telemetry: UsageTelemetryClient;
+    constructor(http: HttpClient);
+    /** The caller's own quota accounts (`GET /usage/quota`; an agent resolves its controller). */
+    quota<T = {
+        accounts: Array<{
+            quotaAccount: string;
+            provider: string;
+        }>;
+    }>(): Promise<T>;
+    /**
+     * POST /usage/quota/samples - the developer's own MCP pushes provider-reported percent + reset
+     * (no token, no secret). Idempotent on (account, window, sampledAt).
+     */
+    postQuotaSample(sample: QuotaSamplePush): Promise<{
+        stored: true;
+    }>;
+}
+//# sourceMappingURL=usage.client.d.ts.map

package/dist/clients/agent/usage.client.d.ts.map

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

package/dist/clients/agent/usage.client.js

@@ -0,0 +1,56 @@
+function qs(range) {
+    const p = new URLSearchParams({ from: range.from, to: range.to });
+    if (range.project)
+        p.set('project', range.project);
+    if (range.role)
+        p.set('role', range.role);
+    return `?${p.toString()}`;
+}
+export class UsageTelemetryClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    run(id) {
+        return this.http.get(`/usage/telemetry/runs/${encodeURIComponent(id)}`);
+    }
+    tasks(range) {
+        return this.http.get(`/usage/telemetry/tasks${qs(range)}`);
+    }
+    tools(range) {
+        return this.http.get(`/usage/telemetry/tools${qs(range)}`);
+    }
+    polls(range) {
+        return this.http.get(`/usage/telemetry/polls${qs(range)}`);
+    }
+    baseload(range) {
+        return this.http.get(`/usage/telemetry/baseload${qs(range)}`);
+    }
+    handbacks(range) {
+        return this.http.get(`/usage/telemetry/handbacks${qs(range)}`);
+    }
+    burnrate(account) {
+        return this.http.get(`/usage/telemetry/burnrate?${new URLSearchParams({ account }).toString()}`);
+    }
+}
+/** `sdk.usage` of the Agent SDK. */
+export class AgentUsageClient {
+    http;
+    telemetry;
+    constructor(http) {
+        this.http = http;
+        this.telemetry = new UsageTelemetryClient(http);
+    }
+    /** The caller's own quota accounts (`GET /usage/quota`; an agent resolves its controller). */
+    quota() {
+        return this.http.get('/usage/quota');
+    }
+    /**
+     * POST /usage/quota/samples - the developer's own MCP pushes provider-reported percent + reset
+     * (no token, no secret). Idempotent on (account, window, sampledAt).
+     */
+    postQuotaSample(sample) {
+        return this.http.post('/usage/quota/samples', sample);
+    }
+}
+//# sourceMappingURL=usage.client.js.map

package/dist/clients/agent/usage.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.client.js","sourceRoot":"","sources":["../../../src/clients/agent/usage.client.ts"],"names":[],"mappings":"AAqFA,SAAS,EAAE,CAAC,KAAqB;IAC7B,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;IACjE,IAAI,KAAK,CAAC,OAAO;QAAE,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAClD,IAAI,KAAK,CAAC,IAAI;QAAE,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IACzC,OAAO,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAA;AAC7B,CAAC;AAED,MAAM,OAAO,oBAAoB;IACA;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAqB,yBAAyB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC/F,CAAC;IACD,KAAK,CAAC,KAAqB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,yBAAyB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7E,CAAC;IACD,KAAK,CAAC,KAAqB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkC,yBAAyB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC/F,CAAC;IACD,KAAK,CAAC,KAAqB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,yBAAyB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7E,CAAC;IACD,QAAQ,CAAC,KAAqB;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,4BAA4B,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChF,CAAC;IACD,SAAS,CAAC,KAAqB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,6BAA6B,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACjF,CAAC;IACD,QAAQ,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAChB,6BAA6B,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC7E,CAAA;IACL,CAAC;CACJ;AAED,oCAAoC;AACpC,MAAM,OAAO,gBAAgB;IAGI;IAFpB,SAAS,CAAsB;IAExC,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAA;IACnD,CAAC;IAED,8FAA8F;IAC9F,KAAK;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAI,cAAc,CAAC,CAAA;IAC3C,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,MAAuB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAmB,sBAAsB,EAAE,MAAM,CAAC,CAAA;IAC3E,CAAC;CACJ"}

package/dist/clients/capture.client.d.ts

@@ -22,6 +22,8 @@ export interface CapturedToolUse {
     durationMs?: number | null;
     /** F239/C543: byte size of tool output string (UTF-8) — the TRUE, uncapped original size. */
     outputBytes?: number | null;
+    /** F779/AC-17: line count of the tool output (counts only, never text). */
+    outputLines?: number | null;
     /**
      * F626/OD-1: the tool output text itself — redacted (`sanitizeToolOutput`,
      * `@beacon-build/core`) and size-capped by the producer BEFORE it ever leaves the process.

package/dist/clients/capture.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.client.d.ts","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOtE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,wEAAwE;IACxE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,qBAAa,aAAa;IAYlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAQlC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;gBAGxC,OAAO,EAAE,MAAM,EAChC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAS1E,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAoB/D"}
+{"version":3,"file":"capture.client.d.ts","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOtE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,wEAAwE;IACxE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,qBAAa,aAAa;IAYlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAQlC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;gBAGxC,OAAO,EAAE,MAAM,EAChC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAS1E,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAoB/D"}

package/dist/clients/capture.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.client.js","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwEH,MAAM,OAAO,aAAa;IAYD;IAXJ,SAAS,CAAQ;IAClC,2FAA2F;IAC3F,4FAA4F;IAC5F,yEAAyE;IACzE,yFAAyF;IACzF,+EAA+E;IAC/E,yFAAyF;IACzF,qBAAqB;IACJ,YAAY,CAAgC;IAE7D,YACqB,OAAe,EAChC,SAA4E;QAD3D,YAAO,GAAP,OAAO,CAAQ;QAGhC,IAAI,CAAC,SAAS,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,qCAAqC,CAAA;QACnF,IAAI,CAAC,YAAY;YACb,OAAO,SAAS,KAAK,UAAU;gBAC3B,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE;gBACvC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAe;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE;aACvD;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC5B,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACV,wEAAwE;YACxE,0EAA0E;YAC1E,uEAAuE;YACvE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;QAC7E,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAqC,CAAA;QACrF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAClE,CAAC;CACJ"}
+{"version":3,"file":"capture.client.js","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0EH,MAAM,OAAO,aAAa;IAYD;IAXJ,SAAS,CAAQ;IAClC,2FAA2F;IAC3F,4FAA4F;IAC5F,yEAAyE;IACzE,yFAAyF;IACzF,+EAA+E;IAC/E,yFAAyF;IACzF,qBAAqB;IACJ,YAAY,CAAgC;IAE7D,YACqB,OAAe,EAChC,SAA4E;QAD3D,YAAO,GAAP,OAAO,CAAQ;QAGhC,IAAI,CAAC,SAAS,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,qCAAqC,CAAA;QACnF,IAAI,CAAC,YAAY;YACb,OAAO,SAAS,KAAK,UAAU;gBAC3B,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE;gBACvC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAe;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE;aACvD;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC5B,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACV,wEAAwE;YACxE,0EAA0E;YAC1E,uEAAuE;YACvE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;QAC7E,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAqC,CAAA;QACrF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAClE,CAAC;CACJ"}

package/dist/clients/knowledge-review.client.d.ts

@@ -0,0 +1,23 @@
+import type { HttpClient } from '../transport/http-client.js';
+import type { KnowledgeReviewQueueOptions, KnowledgeReviewQueueResult, KnowledgeListCommentsOptions, KnowledgeAddCommentInput, KnowledgeComment, KnowledgeApprovalRuleScope, KnowledgePutApprovalRuleInput, KnowledgeApprovalRule } from './knowledge-review.types.js';
+/**
+ * F741: review queue, comments and approval rules of the Knowledge Graph. `KnowledgeClient`
+ * extends this class, so callers keep using `sdk.knowledge.reviewQueue()` and friends; it lives
+ * in its own file only to keep `knowledge.client.ts` under the 300-line guard.
+ */
+export declare class KnowledgeReviewClient {
+    protected readonly http: HttpClient;
+    constructor(http: HttpClient);
+    /** The review work-list: submitted drafts, oldest first, with `can_approve` for the caller. */
+    reviewQueue(opts?: KnowledgeReviewQueueOptions): Promise<KnowledgeReviewQueueResult>;
+    listComments(ref: string, opts?: KnowledgeListCommentsOptions): Promise<KnowledgeComment[]>;
+    addComment(ref: string, input: KnowledgeAddCommentInput): Promise<KnowledgeComment>;
+    /** Resolve (`true`) or reopen (`false`) a comment. */
+    setCommentResolved(commentId: string, resolved: boolean, opts?: {
+        project?: string;
+    }): Promise<KnowledgeComment>;
+    listApprovalRules(scope?: KnowledgeApprovalRuleScope): Promise<KnowledgeApprovalRule[]>;
+    putApprovalRule(nodeType: string, input: KnowledgePutApprovalRuleInput): Promise<KnowledgeApprovalRule>;
+    deleteApprovalRule(nodeType: string, scope?: KnowledgeApprovalRuleScope): Promise<void>;
+}
+//# sourceMappingURL=knowledge-review.client.d.ts.map

package/dist/clients/knowledge-review.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-review.client.d.ts","sourceRoot":"","sources":["../../src/clients/knowledge-review.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,KAAK,EACR,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,EACxB,gBAAgB,EAChB,0BAA0B,EAC1B,6BAA6B,EAC7B,qBAAqB,EACxB,MAAM,6BAA6B,CAAA;AAEpC;;;;GAIG;AACH,qBAAa,qBAAqB;IAClB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU;gBAAhB,IAAI,EAAE,UAAU;IAE/C,+FAA+F;IAC/F,WAAW,CAAC,IAAI,GAAE,2BAAgC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAWxF,YAAY,CACR,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,4BAAiC,GACxC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAW9B,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOnF,sDAAsD;IACtD,kBAAkB,CACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAChC,OAAO,CAAC,gBAAgB,CAAC;IAO5B,iBAAiB,CAAC,KAAK,GAAE,0BAA+B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAU3F,eAAe,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,6BAA6B,GACrC,OAAO,CAAC,qBAAqB,CAAC;IASjC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,0BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;CAS9F"}

package/dist/clients/knowledge-review.client.js

@@ -0,0 +1,61 @@
+/**
+ * F741: review queue, comments and approval rules of the Knowledge Graph. `KnowledgeClient`
+ * extends this class, so callers keep using `sdk.knowledge.reviewQueue()` and friends; it lives
+ * in its own file only to keep `knowledge.client.ts` under the 300-line guard.
+ */
+export class KnowledgeReviewClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** The review work-list: submitted drafts, oldest first, with `can_approve` for the caller. */
+    reviewQueue(opts = {}) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(opts)) {
+            if (value !== undefined)
+                params.set(key, String(value));
+        }
+        const qs = params.toString();
+        return this.http.get(`/knowledge/review-queue${qs ? `?${qs}` : ''}`);
+    }
+    listComments(ref, opts = {}) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(opts)) {
+            if (value !== undefined)
+                params.set(key, String(value));
+        }
+        const qs = params.toString();
+        return this.http.get(`/knowledge/nodes/${encodeURIComponent(ref)}/comments${qs ? `?${qs}` : ''}`);
+    }
+    addComment(ref, input) {
+        return this.http.post(`/knowledge/nodes/${encodeURIComponent(ref)}/comments`, input);
+    }
+    /** Resolve (`true`) or reopen (`false`) a comment. */
+    setCommentResolved(commentId, resolved, opts = {}) {
+        return this.http.patch(`/knowledge/comments/${encodeURIComponent(commentId)}`, { resolved, ...opts });
+    }
+    listApprovalRules(scope = {}) {
+        const params = new URLSearchParams();
+        if (scope.project)
+            params.set('project', scope.project);
+        if (scope.org_id)
+            params.set('org_id', scope.org_id);
+        const qs = params.toString();
+        return this.http.get(`/knowledge/approval-rules${qs ? `?${qs}` : ''}`);
+    }
+    putApprovalRule(nodeType, input) {
+        const { org_id: orgId, ...body } = input;
+        const qs = orgId ? `?org_id=${encodeURIComponent(orgId)}` : '';
+        return this.http.put(`/knowledge/approval-rules/${encodeURIComponent(nodeType)}${qs}`, body);
+    }
+    deleteApprovalRule(nodeType, scope = {}) {
+        const params = new URLSearchParams();
+        if (scope.project)
+            params.set('project', scope.project);
+        if (scope.org_id)
+            params.set('org_id', scope.org_id);
+        const qs = params.toString();
+        return this.http.delete(`/knowledge/approval-rules/${encodeURIComponent(nodeType)}${qs ? `?${qs}` : ''}`);
+    }
+}
+//# sourceMappingURL=knowledge-review.client.js.map

package/dist/clients/knowledge-review.client.js.map

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

package/dist/clients/knowledge-review.types.d.ts

@@ -0,0 +1,91 @@
+export interface KnowledgeReviewQueueOptions {
+    project?: string;
+    scope?: 'project' | 'org' | 'all';
+    type?: string;
+    author?: string;
+    task_id?: string;
+    master?: 'graph' | 'repo' | 'connector';
+    /** Only drafts the caller authored. */
+    mine?: boolean;
+    limit?: number;
+    cursor?: string;
+}
+export interface KnowledgeReviewItem {
+    ref: string;
+    node_id: string;
+    name: string;
+    type: string;
+    version: number;
+    version_id: string;
+    revision: number;
+    author: string;
+    submitted_at: string;
+    open_comments: number;
+    master: 'graph' | 'repo' | 'connector';
+    proposal: boolean;
+    origin?: string;
+    task_id?: string;
+    required_seats: Array<{
+        stable_id: string;
+        name: string;
+    }>;
+    /** A `delivers` draft: only the holder of the seat named Owner approves it. */
+    requires_owner_seat: boolean;
+    four_eyes: boolean;
+    allow_merge_approval: boolean;
+    can_approve: boolean;
+    can_approve_reason?: string;
+}
+export interface KnowledgeReviewQueueResult {
+    items: KnowledgeReviewItem[];
+    next_cursor: string | null;
+}
+export interface KnowledgeListCommentsOptions {
+    project?: string;
+    version?: number;
+    open?: boolean;
+    section_id?: string;
+}
+export interface KnowledgeAddCommentInput {
+    body: string;
+    version?: number;
+    section_id?: string;
+    project?: string;
+}
+export interface KnowledgeComment {
+    id: string;
+    version: number;
+    section_id: string | null;
+    body: string;
+    author: string;
+    kind: 'comment' | 'rejection';
+    resolved_at: string | null;
+    resolved_by: string | null;
+    outdated: boolean;
+    created_at: string;
+    carried_from_version?: number;
+}
+export interface KnowledgeApprovalRuleScope {
+    project?: string;
+    /** The organization of the project: addresses the org-level rules. */
+    org_id?: string;
+}
+export interface KnowledgePutApprovalRuleInput extends KnowledgeApprovalRuleScope {
+    /** A seat `stable_id` or `ref` — a name is not an identity. */
+    seat?: string | null;
+    four_eyes: boolean;
+    allow_merge_approval: boolean;
+}
+export interface KnowledgeApprovalRule {
+    node_type: string;
+    seat: {
+        stable_id: string;
+        ref: string;
+        name: string;
+        status: 'ok' | 'deprecated' | 'missing';
+    } | null;
+    four_eyes: boolean;
+    allow_merge_approval: boolean;
+    updated_at: string;
+}
+//# sourceMappingURL=knowledge-review.types.d.ts.map

package/dist/clients/knowledge-review.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-review.types.d.ts","sourceRoot":"","sources":["../../src/clients/knowledge-review.types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,CAAA;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;IACvC,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;IACtC,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1D,+EAA+E;IAC/E,mBAAmB,EAAE,OAAO,CAAA;IAC5B,SAAS,EAAE,OAAO,CAAA;IAClB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,WAAW,EAAE,OAAO,CAAA;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACvC,KAAK,EAAE,mBAAmB,EAAE,CAAA;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,4BAA4B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,GAAG,WAAW,CAAA;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,0BAA0B;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,6BAA8B,SAAQ,0BAA0B;IAC7E,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,oBAAoB,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE;QACF,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,SAAS,CAAA;KAC1C,GAAG,IAAI,CAAA;IACR,SAAS,EAAE,OAAO,CAAA;IAClB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;CACrB"}

package/dist/clients/knowledge-review.types.js

@@ -0,0 +1,3 @@
+// F741: review queue, comments and approval rules of the Knowledge Graph.
+export {};
+//# sourceMappingURL=knowledge-review.types.js.map

package/dist/clients/knowledge-review.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-review.types.js","sourceRoot":"","sources":["../../src/clients/knowledge-review.types.ts"],"names":[],"mappings":"AAAA,0EAA0E"}

package/dist/clients/knowledge.client.d.ts

@@ -1,10 +1,16 @@
-import type { HttpClient } from '../transport/http-client.js';
-import type { KnowledgeSearchOptions, KnowledgeNodeGetOptions, KnowledgeOutlineOptions, KnowledgeHistoryOptions, KnowledgeDiffOptions, KnowledgeCreateNodeInput, KnowledgePatchInput, KnowledgeDraftInput, KnowledgeDecisionInput, KnowledgeQuestionInput, KnowledgeLinkInput, KnowledgeTransitionInput, KnowledgeSetMasterInput, KnowledgeApproveDraftsOptions, KnowledgeSearchResult, KnowledgeNodeResult, KnowledgeOutlineResult, KnowledgeHistoryResult, KnowledgeDiffResult, KnowledgeDraftResult, KnowledgeDecisionResult, KnowledgeQuestionResult, KnowledgeTransitionResult, KnowledgeSetMasterResult, NodeTaskLink, TaskModelLink, TaskModelLinkInput, TaskModelLinkResult } from './knowledge.types.js';
+import { KnowledgeReviewClient } from './knowledge-review.client.js';
+import type { KnowledgeSearchOptions, KnowledgeNodeGetOptions, KnowledgeOutlineOptions, KnowledgeHistoryOptions, KnowledgeDiffOptions, KnowledgeCreateNodeInput, KnowledgePatchInput, KnowledgeDraftInput, KnowledgeDecisionInput, KnowledgeQuestionInput, KnowledgeLinkInput, KnowledgeTransitionInput, KnowledgeSetMasterInput, KnowledgeApproveDraftsOptions, KnowledgeSearchResult, KnowledgeContextOptions, KnowledgeContextResult, KnowledgeNodeResult, KnowledgeOutlineResult, KnowledgeHistoryResult, KnowledgeDiffResult, KnowledgeDraftResult, KnowledgeDecisionResult, KnowledgeQuestionResult, KnowledgeTransitionResult, KnowledgeSetMasterResult, NodeTaskLink, TaskModelLink, TaskModelLinkInput, TaskModelLinkResult } from './knowledge.types.js';
 export * from './knowledge.types.js';
-export declare class KnowledgeClient {
-    private readonly http;
-    constructor(http: HttpClient);
+export * from './knowledge-review.types.js';
+export { KnowledgeReviewClient } from './knowledge-review.client.js';
+/** F741's review / comment / approval-rule methods are inherited from `KnowledgeReviewClient`. */
+export declare class KnowledgeClient extends KnowledgeReviewClient {
     search(query: string, opts?: KnowledgeSearchOptions): Promise<KnowledgeSearchResult>;
+    /**
+     * F742: the context of a task - the guaranteed guardrail set, the nodes linked to the task and
+     * the top-k relevant approved nodes (`GET /knowledge/context`).
+     */
+    context(taskId: string, opts?: KnowledgeContextOptions): Promise<KnowledgeContextResult>;
     get(ref: string, opts?: KnowledgeNodeGetOptions): Promise<KnowledgeNodeResult>;
     outline(ref: string, opts?: KnowledgeOutlineOptions): Promise<KnowledgeOutlineResult>;
     history(ref: string, opts?: KnowledgeHistoryOptions): Promise<KnowledgeHistoryResult>;
@@ -36,6 +42,6 @@ export declare class KnowledgeClient {
     }): Promise<NodeTaskLink[]>;
     transition(ref: string, input: KnowledgeTransitionInput): Promise<KnowledgeTransitionResult>;
     setMaster(ref: string, input: KnowledgeSetMasterInput): Promise<KnowledgeSetMasterResult>;
-    approveTaskDrafts(taskId: string, opts?: KnowledgeApproveDraftsOptions): Promise<Record<string, unknown>>;
+    approveTaskDrafts(taskId: string, opts: KnowledgeApproveDraftsOptions): Promise<Record<string, unknown>>;
 }
 //# sourceMappingURL=knowledge.client.d.ts.map

package/dist/clients/knowledge.client.d.ts.map

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

package/dist/clients/knowledge.client.js

@@ -1,9 +1,9 @@
+import { KnowledgeReviewClient } from './knowledge-review.client.js';
 export * from './knowledge.types.js';
-export class KnowledgeClient {
-    http;
-    constructor(http) {
-        this.http = http;
-    }
+export * from './knowledge-review.types.js';
+export { KnowledgeReviewClient } from './knowledge-review.client.js';
+/** F741's review / comment / approval-rule methods are inherited from `KnowledgeReviewClient`. */
+export class KnowledgeClient extends KnowledgeReviewClient {
     search(query, opts = {}) {
         const params = new URLSearchParams();
         if (query)
@@ -29,6 +29,20 @@ export class KnowledgeClient {
         const qs = params.toString();
         return this.http.get(`/knowledge/search${qs ? `?${qs}` : ''}`);
     }
+    /**
+     * F742: the context of a task - the guaranteed guardrail set, the nodes linked to the task and
+     * the top-k relevant approved nodes (`GET /knowledge/context`).
+     */
+    context(taskId, opts = {}) {
+        const params = new URLSearchParams({ task_id: taskId });
+        if (opts.k !== undefined)
+            params.set('k', String(opts.k));
+        if (opts.guardrail_content)
+            params.set('guardrail_content', opts.guardrail_content);
+        if (opts.project)
+            params.set('project', opts.project);
+        return this.http.get(`/knowledge/context?${params.toString()}`);
+    }
     get(ref, opts = {}) {
         const params = new URLSearchParams();
         if (opts.version !== undefined)
@@ -130,7 +144,7 @@ export class KnowledgeClient {
     setMaster(ref, input) {
         return this.http.post(`/knowledge/nodes/${encodeURIComponent(ref)}/master`, input);
     }
-    approveTaskDrafts(taskId, opts = {}) {
+    approveTaskDrafts(taskId, opts) {
         return this.http.post(`/knowledge/tasks/${encodeURIComponent(taskId)}/approve-drafts`, opts);
     }
 }