@qodo/sdk 0.13.4 → 2.0.0-next.0

package/dist/client/QodoClient.js.map

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

package/dist/client/SpecsClient.d.ts

@@ -0,0 +1,121 @@
+/**
+ * `SpecsClient` — backed by `POST /v1/specs/validate` on QAR.
+ *
+ * Stateless pre-flight: validates an inline `AgentSpec` or `GraphSpec`
+ * against the same wire-validation rules `task.start` runs, but without
+ * dispatching anything. Useful for:
+ *
+ *   - **CI gates** — consumer repos run `client.specs.validate(spec)` in a
+ *     PR check; failure on any spec rule blocks merge.
+ *   - **Studio live-edit** — every keystroke in the visual editor calls
+ *     validate; instant feedback while the user authors.
+ *   - **SDK pre-flight** — a developer iterating on an inline spec in a
+ *     notebook validates before calling `tasks.start`.
+ *
+ * Bearer auth is *forwarded if available* but not required by the endpoint.
+ * Validation is a pure function over the spec shape — no PII, no tenant
+ * resolution. A bearer is included only so Qodo Cloud can attribute the call
+ * for audit purposes when one is configured.
+ *
+ * Per-rule failures (`{ valid: false, errors: [{ rule_id, path, message }] }`)
+ * are *not* exceptions — they're the normal happy-path return. Only
+ * pre-wire issues (missing `kind`, unreachable host, non-2xx HTTP) throw.
+ */
+import type { InlineAgentSpec, InlineGraphSpec, SpecValidateResult } from '../qar/specs.js';
+export declare class SpecsClient {
+    private readonly baseUrl;
+    private readonly allowInsecureTransport;
+    private readonly authProvider;
+    private readonly extraHeaders;
+    private readonly fetchImpl;
+    private cachedHttpBase;
+    /**
+     * Memoized bearer resolution. Three states:
+     *   - `undefined` — never resolved yet.
+     *   - `string`    — bearer was found and is reused on subsequent calls.
+     *   - `null`      — confirmed "no bearer configured"; we won't probe again.
+     *
+     * `AuthProvider.validate()` does synchronous filesystem work and throws
+     * `QodoAuthError` when no key exists anywhere. In high-frequency scenarios
+     * (CI gating many specs, Studio live-edit per keystroke) re-running that on
+     * every call would burn syscalls and throw/catch loops. Cache the answer.
+     */
+    private cachedBearer;
+    /**
+     * Validate an `AgentSpec` or `GraphSpec` against QAR's wire-validation
+     * rules without dispatching a task.
+     *
+     * Returns the typed `SpecValidateResult` envelope:
+     *   - `{ valid: true }` — the spec passed every rule.
+     *   - `{ valid: false, errors: [...] }` — the spec failed one or more
+     *     rules; each entry is `{ rule_id, path, message }` where `rule_id` is
+     *     a `D10-R*` (AgentSpec) or `D11-R*` (GraphSpec) tag and `path` is a
+     *     JSON Pointer (RFC 6901) into the spec (`""` for the root).
+     *
+     * Throws:
+     *   - `QodoSpecValidationError` — the supplied object is missing a known
+     *     `kind` discriminator, so it's not a well-formed spec at all. (Per-rule
+     *     failures are *not* exceptions — they come back as `valid: false`.)
+     *   - `QodoAuthError` — only when a bearer was provided and the server
+     *     rejected it (401/403). When no bearer is configured the endpoint is
+     *     anonymous, so 401/403 surfaces as a plain `Error` instead.
+     *   - plain `Error` — any other non-2xx response, with the body included.
+     */
+    validate(spec: InlineAgentSpec | InlineGraphSpec): Promise<SpecValidateResult>;
+    /**
+     * Try to resolve a bearer without throwing if none is configured.
+     *
+     * `AuthProvider.validate()` throws `QodoAuthError` when no key is found
+     * anywhere — that's the right call for `tasks.start` (auth required) but
+     * the wrong one here (validate is anonymous-friendly). We swallow that
+     * specific error and treat it as "no bearer" so the call proceeds without
+     * an `Authorization` header. Any other thrown shape (filesystem error
+     * inside `validate`, etc.) propagates so we don't mask real bugs.
+     *
+     * Memoized via `cachedBearer` — once the answer is known we don't re-probe
+     * the filesystem on every call. CI gating many specs and Studio live-edit
+     * are both high-frequency callers of `validate()`.
+     */
+    private tryResolveBearer;
+    /**
+     * Apply the wire-default `kind` discriminator to an `InlineAgentSpec` whose
+     * type-optional `kind` was omitted. The check is duck-type: an object with
+     * `apiVersion: 'qar/v1'` + no explicit `kind` is treated as an AgentSpec
+     * (the only optional-kind arm of `InlineSpec` — `InlineGraphSpec.kind` is
+     * required by the type and `assertSpecKind` enforces it). Anything else
+     * passes through untouched and gets caught by `assertSpecKind` below.
+     *
+     * Mirrors `TaskClient.startWithAgent`'s `normalizeInlineAgentSpec` call so
+     * the SDK presents one consistent normalization story regardless of which
+     * entry point the consumer uses.
+     */
+    private static normalizeKind;
+    /**
+     * Reject anything that isn't a JSON object with a recognized `kind`
+     * discriminator. JS callers can pass `null`, undefined, primitives, etc. —
+     * fail fast with a typed error rather than letting `JSON.stringify` ship
+     * `null`/`"foo"` to the endpoint.
+     *
+     * Accepts only the wire-canonical `kind: 'AgentSpec' | 'GraphSpec'` literals
+     * matching QAR's `SPEC_KIND_AGENT` / `SPEC_KIND_GRAPH`. The legacy lowercase
+     * `'graph'` arm was dropped — the wire validator only ever accepted the
+     * capitalized form, so consumers carrying the old literal now get a typed
+     * pre-wire error instead of a `task.done(failed)` round-trip.
+     */
+    private static assertSpecKind;
+    /**
+     * Lazy URL parsing — symmetric with `InfoClient.requireHttpBase`.
+     * `QodoClient.validateOptions` only checks `baseUrl` is a non-empty string;
+     * eager derivation would change behavior for callers who construct a client
+     * with an invalid scheme but never call any HTTP method.
+     */
+    private requireHttpBase;
+    private static readBodySafely;
+    /**
+     * Map the consumer-supplied `baseUrl` (typically `https://qar.qodo.ai` or
+     * `wss://qar.qodo.ai`) onto the HTTP origin used for `/v1/specs/validate`.
+     * Same scheme rules + insecure-transport gate as `InfoClient`.
+     */
+    private static deriveHttpBaseUrl;
+}
+//# sourceMappingURL=SpecsClient.d.ts.map

package/dist/client/SpecsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpecsClient.d.ts","sourceRoot":"","sources":["../../src/client/SpecsClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAezB,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,cAAc,CAAuB;IAC7C;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY,CAAwC;IAW5D;;;;;;;;;;;;;;;;;;;OAmBG;IACU,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmD3F;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAS5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAc7B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;mBASF,cAAc;IAUnC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAgCjC"}

package/dist/client/SpecsClient.js

@@ -0,0 +1,252 @@
+/**
+ * `SpecsClient` — backed by `POST /v1/specs/validate` on QAR.
+ *
+ * Stateless pre-flight: validates an inline `AgentSpec` or `GraphSpec`
+ * against the same wire-validation rules `task.start` runs, but without
+ * dispatching anything. Useful for:
+ *
+ *   - **CI gates** — consumer repos run `client.specs.validate(spec)` in a
+ *     PR check; failure on any spec rule blocks merge.
+ *   - **Studio live-edit** — every keystroke in the visual editor calls
+ *     validate; instant feedback while the user authors.
+ *   - **SDK pre-flight** — a developer iterating on an inline spec in a
+ *     notebook validates before calling `tasks.start`.
+ *
+ * Bearer auth is *forwarded if available* but not required by the endpoint.
+ * Validation is a pure function over the spec shape — no PII, no tenant
+ * resolution. A bearer is included only so Qodo Cloud can attribute the call
+ * for audit purposes when one is configured.
+ *
+ * Per-rule failures (`{ valid: false, errors: [{ rule_id, path, message }] }`)
+ * are *not* exceptions — they're the normal happy-path return. Only
+ * pre-wire issues (missing `kind`, unreachable host, non-2xx HTTP) throw.
+ */
+import { QodoAuthError } from '../auth/index.js';
+import { QodoClientOptionsError, QodoSpecValidationError, } from './errors.js';
+import { normalizeInlineAgentSpec } from '../qar/agentSpec.js';
+export class SpecsClient {
+    baseUrl;
+    allowInsecureTransport;
+    authProvider;
+    extraHeaders;
+    fetchImpl;
+    cachedHttpBase = null;
+    /**
+     * Memoized bearer resolution. Three states:
+     *   - `undefined` — never resolved yet.
+     *   - `string`    — bearer was found and is reused on subsequent calls.
+     *   - `null`      — confirmed "no bearer configured"; we won't probe again.
+     *
+     * `AuthProvider.validate()` does synchronous filesystem work and throws
+     * `QodoAuthError` when no key exists anywhere. In high-frequency scenarios
+     * (CI gating many specs, Studio live-edit per keystroke) re-running that on
+     * every call would burn syscalls and throw/catch loops. Cache the answer.
+     */
+    cachedBearer = undefined;
+    /** @internal — constructed by `QodoClient`. */
+    constructor(deps) {
+        this.baseUrl = deps.baseUrl;
+        this.allowInsecureTransport = deps.allowInsecureTransport ?? false;
+        this.authProvider = deps.authProvider;
+        this.extraHeaders = deps.headers ?? {};
+        this.fetchImpl = deps.fetchImpl ?? ((input, init) => fetch(input, init));
+    }
+    /**
+     * Validate an `AgentSpec` or `GraphSpec` against QAR's wire-validation
+     * rules without dispatching a task.
+     *
+     * Returns the typed `SpecValidateResult` envelope:
+     *   - `{ valid: true }` — the spec passed every rule.
+     *   - `{ valid: false, errors: [...] }` — the spec failed one or more
+     *     rules; each entry is `{ rule_id, path, message }` where `rule_id` is
+     *     a `D10-R*` (AgentSpec) or `D11-R*` (GraphSpec) tag and `path` is a
+     *     JSON Pointer (RFC 6901) into the spec (`""` for the root).
+     *
+     * Throws:
+     *   - `QodoSpecValidationError` — the supplied object is missing a known
+     *     `kind` discriminator, so it's not a well-formed spec at all. (Per-rule
+     *     failures are *not* exceptions — they come back as `valid: false`.)
+     *   - `QodoAuthError` — only when a bearer was provided and the server
+     *     rejected it (401/403). When no bearer is configured the endpoint is
+     *     anonymous, so 401/403 surfaces as a plain `Error` instead.
+     *   - plain `Error` — any other non-2xx response, with the body included.
+     */
+    async validate(spec) {
+        // Normalize before the kind-check so an `InlineAgentSpec` literal that
+        // omits the optional `kind` discriminator (`{ apiVersion, instructions,
+        // model }`) round-trips against QAR with the wire-canonical `kind:
+        // 'AgentSpec'` filled in. Mirrors `TaskClient.startWithAgent`'s behavior
+        // so consumers see the same normalization regardless of which entry
+        // point they use. `InlineGraphSpec.kind` is required at the type level,
+        // so the normalization only ever fires on the AgentSpec arm.
+        const normalized = SpecsClient.normalizeKind(spec);
+        SpecsClient.assertSpecKind(normalized);
+        const url = `${this.requireHttpBase()}/v1/specs/validate`;
+        const bearer = this.tryResolveBearer();
+        // Build headers via the case-insensitive `Headers` API and explicitly
+        // strip any caller-supplied `Authorization` before setting the
+        // SDK-controlled bearer. This matters because `ClientOptions.headers` is
+        // documented as "extra headers"; bearer auth must be controlled
+        // exclusively via `ClientOptions.auth`. Plain object spread is
+        // case-sensitive, so a caller's lowercase `authorization` would slip
+        // through alongside our `Authorization`. `Headers.set` collapses both.
+        const headers = new Headers(this.extraHeaders);
+        headers.delete('authorization');
+        headers.set('Content-Type', 'application/json');
+        headers.set('Accept', 'application/json');
+        if (bearer !== null) {
+            headers.set('Authorization', `Bearer ${bearer}`);
+        }
+        const response = await this.fetchImpl(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(normalized),
+        });
+        if (response.status === 401 || response.status === 403) {
+            // Only the auth-source-named error makes sense when we actually sent a
+            // bearer. If the caller didn't configure one, a 401/403 is an endpoint
+            // policy decision (not a key-fix-up) — fall through to the generic Error.
+            if (bearer !== null) {
+                this.authProvider.handle401Error();
+            }
+        }
+        if (!response.ok) {
+            const body = await SpecsClient.readBodySafely(response);
+            throw new Error(`POST /v1/specs/validate failed: ${response.status} ${response.statusText}${body ? ` — ${body}` : ''}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Try to resolve a bearer without throwing if none is configured.
+     *
+     * `AuthProvider.validate()` throws `QodoAuthError` when no key is found
+     * anywhere — that's the right call for `tasks.start` (auth required) but
+     * the wrong one here (validate is anonymous-friendly). We swallow that
+     * specific error and treat it as "no bearer" so the call proceeds without
+     * an `Authorization` header. Any other thrown shape (filesystem error
+     * inside `validate`, etc.) propagates so we don't mask real bugs.
+     *
+     * Memoized via `cachedBearer` — once the answer is known we don't re-probe
+     * the filesystem on every call. CI gating many specs and Studio live-edit
+     * are both high-frequency callers of `validate()`.
+     */
+    tryResolveBearer() {
+        if (this.cachedBearer !== undefined)
+            return this.cachedBearer;
+        try {
+            this.authProvider.validate();
+        }
+        catch (err) {
+            if (err instanceof QodoAuthError) {
+                this.cachedBearer = null;
+                return null;
+            }
+            throw err;
+        }
+        const { token } = this.authProvider.getAuthConfig();
+        this.cachedBearer = token.length > 0 ? token : null;
+        return this.cachedBearer;
+    }
+    /**
+     * Apply the wire-default `kind` discriminator to an `InlineAgentSpec` whose
+     * type-optional `kind` was omitted. The check is duck-type: an object with
+     * `apiVersion: 'qar/v1'` + no explicit `kind` is treated as an AgentSpec
+     * (the only optional-kind arm of `InlineSpec` — `InlineGraphSpec.kind` is
+     * required by the type and `assertSpecKind` enforces it). Anything else
+     * passes through untouched and gets caught by `assertSpecKind` below.
+     *
+     * Mirrors `TaskClient.startWithAgent`'s `normalizeInlineAgentSpec` call so
+     * the SDK presents one consistent normalization story regardless of which
+     * entry point the consumer uses.
+     */
+    static normalizeKind(spec) {
+        if (typeof spec !== 'object' || spec === null)
+            return spec;
+        const kind = spec.kind;
+        if (kind === undefined && spec.apiVersion === 'qar/v1') {
+            return normalizeInlineAgentSpec(spec);
+        }
+        return spec;
+    }
+    /**
+     * Reject anything that isn't a JSON object with a recognized `kind`
+     * discriminator. JS callers can pass `null`, undefined, primitives, etc. —
+     * fail fast with a typed error rather than letting `JSON.stringify` ship
+     * `null`/`"foo"` to the endpoint.
+     *
+     * Accepts only the wire-canonical `kind: 'AgentSpec' | 'GraphSpec'` literals
+     * matching QAR's `SPEC_KIND_AGENT` / `SPEC_KIND_GRAPH`. The legacy lowercase
+     * `'graph'` arm was dropped — the wire validator only ever accepted the
+     * capitalized form, so consumers carrying the old literal now get a typed
+     * pre-wire error instead of a `task.done(failed)` round-trip.
+     */
+    static assertSpecKind(spec) {
+        if (typeof spec !== 'object' || spec === null) {
+            throw new QodoSpecValidationError(`client.specs.validate(spec): spec must be an object with a "kind" of "AgentSpec" or "GraphSpec"`);
+        }
+        const kind = spec.kind;
+        if (kind !== 'AgentSpec' && kind !== 'GraphSpec') {
+            throw new QodoSpecValidationError(`client.specs.validate(spec): spec.kind must be "AgentSpec" or "GraphSpec"; got ${JSON.stringify(kind)}`);
+        }
+    }
+    /**
+     * Lazy URL parsing — symmetric with `InfoClient.requireHttpBase`.
+     * `QodoClient.validateOptions` only checks `baseUrl` is a non-empty string;
+     * eager derivation would change behavior for callers who construct a client
+     * with an invalid scheme but never call any HTTP method.
+     */
+    requireHttpBase() {
+        if (this.cachedHttpBase !== null)
+            return this.cachedHttpBase;
+        this.cachedHttpBase = SpecsClient.deriveHttpBaseUrl(this.baseUrl, this.allowInsecureTransport);
+        return this.cachedHttpBase;
+    }
+    static async readBodySafely(response) {
+        try {
+            const text = await response.text();
+            return text.length > 512 ? `${text.slice(0, 512)}…` : text;
+        }
+        catch {
+            // Body read errors are non-actionable here — caller already has status / statusText.
+            return '';
+        }
+    }
+    /**
+     * Map the consumer-supplied `baseUrl` (typically `https://qar.qodo.ai` or
+     * `wss://qar.qodo.ai`) onto the HTTP origin used for `/v1/specs/validate`.
+     * Same scheme rules + insecure-transport gate as `InfoClient`.
+     */
+    static deriveHttpBaseUrl(baseUrl, allowInsecureTransport) {
+        let end = baseUrl.length;
+        while (end > 0 && baseUrl.charCodeAt(end - 1) === 0x2f /* '/' */) {
+            end -= 1;
+        }
+        const trimmed = baseUrl.slice(0, end);
+        let httpBase;
+        let insecure = false;
+        if (trimmed.startsWith('https://')) {
+            httpBase = trimmed;
+        }
+        else if (trimmed.startsWith('http://')) {
+            httpBase = trimmed;
+            insecure = true;
+        }
+        else if (trimmed.startsWith('wss://')) {
+            httpBase = `https://${trimmed.slice('wss://'.length)}`;
+        }
+        else if (trimmed.startsWith('ws://')) {
+            httpBase = `http://${trimmed.slice('ws://'.length)}`;
+            insecure = true;
+        }
+        else {
+            throw new QodoClientOptionsError(`ClientOptions.baseUrl must use http(s):// or ws(s)://; got "${baseUrl}"`);
+        }
+        if (insecure && allowInsecureTransport !== true) {
+            throw new QodoClientOptionsError(`ClientOptions.baseUrl uses an insecure scheme ("${baseUrl}") which would transmit ` +
+                `the bearer token in plaintext. Use https:// or wss:// in production, or set ` +
+                `allowInsecureTransport: true to opt in for local development.`);
+        }
+        return httpBase;
+    }
+}
+//# sourceMappingURL=SpecsClient.js.map

package/dist/client/SpecsClient.js.map

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

package/dist/client/StateClient.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `StateClient` — observer for QAR's `state.update` envelopes.
+ *
+ * State updates are per-skill mutations: a `skill` keys the schema and `op`
+ * (`patch` / `replace` / `init`) describes the mutation kind. The payload
+ * shape is typed by QAR (codegen overlay in `src/qar/payloads.ts`); the
+ * filter helper here narrows by skill so consumers can wire one handler
+ * per skill without de-multiplexing themselves.
+ *
+ * `state.update` is bidirectional in QAR's wire model; this surface is
+ * server→client only (the inbound stream). SDK-side emission for
+ * skill-managed state pushes is reserved for a future ticket.
+ */
+import type { StateUpdateEnvelope } from '../qar/envelopes.js';
+import { KindObserverClient } from './observers.js';
+import type { EventSubscription } from './observers.js';
+/** Filter for `state.update` envelopes. */
+export interface StateFilter {
+    /** Match against `payload.skill` — the skill key whose state is mutating. */
+    readonly skill?: string;
+}
+export type StateHandler = (env: StateUpdateEnvelope) => void;
+export declare class StateClient extends KindObserverClient<'state.update', StateUpdateEnvelope> {
+    /**
+     * Register a handler invoked for every inbound `state.update` envelope.
+     *
+     * Same multi-handler / fan-out / throw-swallowing semantics as the other
+     * observer surfaces. The two-arg overload accepts a `StateFilter` (only
+     * `skill` for now — `op` would be cheap to add but we'd rather grow the
+     * filter when consumers ask).
+     */
+    onUpdate(handler: StateHandler): EventSubscription;
+    onUpdate(filter: StateFilter, handler: StateHandler): EventSubscription;
+}
+//# sourceMappingURL=StateClient.d.ts.map

package/dist/client/StateClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateClient.d.ts","sourceRoot":"","sources":["../../src/client/StateClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAE9D,qBAAa,WAAY,SAAQ,kBAAkB,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAMtF;;;;;;;OAOG;IACI,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB;IAClD,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,GAAG,iBAAiB;CAc/E"}

package/dist/client/StateClient.js

@@ -0,0 +1,36 @@
+/**
+ * `StateClient` — observer for QAR's `state.update` envelopes.
+ *
+ * State updates are per-skill mutations: a `skill` keys the schema and `op`
+ * (`patch` / `replace` / `init`) describes the mutation kind. The payload
+ * shape is typed by QAR (codegen overlay in `src/qar/payloads.ts`); the
+ * filter helper here narrows by skill so consumers can wire one handler
+ * per skill without de-multiplexing themselves.
+ *
+ * `state.update` is bidirectional in QAR's wire model; this surface is
+ * server→client only (the inbound stream). SDK-side emission for
+ * skill-managed state pushes is reserved for a future ticket.
+ */
+import { KindObserverClient } from './observers.js';
+export class StateClient extends KindObserverClient {
+    /** @internal — instantiated by `QodoClient`. */
+    constructor() {
+        super('state.update');
+    }
+    onUpdate(filterOrHandler, maybeHandler) {
+        if (typeof filterOrHandler === 'function') {
+            return this.register(filterOrHandler);
+        }
+        if (maybeHandler === undefined) {
+            throw new Error('StateClient.onUpdate: handler is required when a filter is supplied');
+        }
+        const filter = filterOrHandler;
+        return this.register(maybeHandler, (env) => stateMatches(env, filter));
+    }
+}
+function stateMatches(env, filter) {
+    if (filter.skill !== undefined && env.payload.skill !== filter.skill)
+        return false;
+    return true;
+}
+//# sourceMappingURL=StateClient.js.map

package/dist/client/StateClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateClient.js","sourceRoot":"","sources":["../../src/client/StateClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAWpD,MAAM,OAAO,WAAY,SAAQ,kBAAuD;IACtF,gDAAgD;IAChD;QACE,KAAK,CAAC,cAAc,CAAC,CAAC;IACxB,CAAC;IAYM,QAAQ,CACb,eAA2C,EAC3C,YAA2B;QAE3B,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,MAAM,GAAG,eAAe,CAAC;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;CACF;AAED,SAAS,YAAY,CAAC,GAAwB,EAAE,MAAmB;IACjE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC"}