@dsh-cc/side-query 0.8.0-rc.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm check:readme --write
+README.md: 411778a1c3436cbcf8d4b8a8885dbe2633d8357b
+README.zh.md: 9e3bf6a2a4764039d4fc194e2909c24523ab549f

package/README.md

@@ -0,0 +1,39 @@
+# @dsh-cc/side-query
+
+English | [中文](README.zh.md)
+
+The **side-query primitive**: a declarative, never-throws, non-streaming auxiliary LLM call for harness features that need a small/fast model answer off the main agent loop (design: docs/plans/2026-09-15-side-queries.md). Before this package, web_fetch's page summarizer, the session-title provider, and the permission auto-mode classifier each hand-rolled their own one-shot call with drifting timeout/failure/route semantics; `runSideQuery` is the single shared shape.
+
+## API
+
+```ts
+export interface SideQueryOptions {
+  agent: Agent                      // required: provider fill via agent.session.requestHeader (web-fetch precedent)
+  alias?: string                    // default 'haiku' (resolveAlias / ccModelRoutes lane)
+  system?: string
+  prompt: string
+  maxTokens?: number                // default 512
+  timeoutMs?: number                // default 8000
+  signal?: AbortSignal              // caller-owned; composed with the timeout (AbortSignal.any)
+  onUnrouted?: 'inherit' | 'skip'   // default 'inherit' (alias unconfigured -> parent route)
+  rejectToolCalls?: boolean         // default true
+}
+
+export type SideQueryResult =
+  | { ok: true; text: string; inheritedRoute: boolean; durationMs: number }
+  | { ok: false; reason: 'unrouted' | 'timeout' | 'error' | 'empty'; inheritedRoute?: boolean }
+
+export async function runSideQuery(ctx: Context, opts: SideQueryOptions): Promise<SideQueryResult>
+```
+
+## Semantics
+
+- **Never throws.** Every failure shape — unrouted alias, timeout, adapter error, empty text — collapses into `SideQueryResult`. The dsh-llm runtime normalizes adapter throws into terminal error chunks, so `reason: 'error'` covers both paths.
+- Non-streaming contract: consumes `ctx.llm.stream` through the BlockAssembler pattern and awaits the full text (the `tool-web-fetch` one-shot pattern).
+- `rejectToolCalls` (default) rejects streams that emit tool-call blocks. A side query that tries to *act* is a bug, not a capability (the memory recall-selector rogue-execution lesson).
+- `inheritedRoute` reports whether the alias fell back to the parent route, so consumers can meter zero-savings runs (see `warnOnInherit` in `@dsh-cc/cc-model-aliases`).
+- No retry, no cache, no persistence, no ledger — those belong to consumers (e.g. `@dsh-cc/tool-use-summary` keeps the ledger).
+
+## Shape
+
+Library package: no preset row, no settings namespace, no capability-manifest entry. Consumers depend on it with `workspace:^` and add a project reference in their own `tsconfig.json`.

package/README.zh.md

@@ -0,0 +1,39 @@
+# @dsh-cc/side-query
+
+English | [中文](README.md)
+
+**side-query 原语**：声明式、绝不抛异常、非流式的辅助 LLM 调用，供 harness 中需要小/快模型在主 Agent 循环之外作答的特性使用（设计文档：docs/plans/2026-09-15-side-queries.md）。在本包之前，web_fetch 的页面摘要、session-title 提供器、权限 auto 模式分类器各自手写一次性调用，超时/失败/路由语义相互漂移；`runSideQuery` 是收敛后的唯一形态。
+
+## API
+
+```ts
+export interface SideQueryOptions {
+  agent: Agent                      // 必填：经 agent.session.requestHeader 补齐路由的 provider 半（web-fetch 先例）
+  alias?: string                    // 默认 'haiku'（resolveAlias / ccModelRoutes 通道）
+  system?: string
+  prompt: string
+  maxTokens?: number                // 默认 512
+  timeoutMs?: number                // 默认 8000
+  signal?: AbortSignal              // 调用方持有；与超时组合（AbortSignal.any）
+  onUnrouted?: 'inherit' | 'skip'   // 默认 'inherit'（alias 未配置 → 继承父路由）
+  rejectToolCalls?: boolean         // 默认 true
+}
+
+export type SideQueryResult =
+  | { ok: true; text: string; inheritedRoute: boolean; durationMs: number }
+  | { ok: false; reason: 'unrouted' | 'timeout' | 'error' | 'empty'; inheritedRoute?: boolean }
+
+export async function runSideQuery(ctx: Context, opts: SideQueryOptions): Promise<SideQueryResult>
+```
+
+## 语义
+
+- **绝不抛异常**。所有失败形态——alias 无路由、超时、adapter 错误、空文本——都收敛进 `SideQueryResult`。dsh-llm runtime 会把 adapter 抛错规范化为终止 error chunk，因此两条路径都映射到 `reason: 'error'`。
+- 非流式契约：内部经 BlockAssembler 模式消费 `ctx.llm.stream` 并等待完整文本（`tool-web-fetch` 的一次性调用模式）。
+- `rejectToolCalls`（默认开启）拒绝发出 tool-call 块的流：side query 试图"动手"是 bug 而不是能力（memory recall selector 幻影执行事故的教训）。
+- `inheritedRoute` 报告 alias 是否回落到了父路由，供消费方计量"零节省"运行（配合 `@dsh-cc/cc-model-aliases` 的 `warnOnInherit`）。
+- 无重试、无缓存、无持久化、无账本——这些属于消费方（如 `@dsh-cc/tool-use-summary` 自带账本）。
+
+## 形态
+
+纯库包：无 preset 行、无 settings 命名空间、无 capability manifest 条目。消费方以 `workspace:^` 依赖它，并在自己的 `tsconfig.json` 中加 project reference。

package/lib/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * First-class auxiliary-LLM primitive: a one-shot, non-streaming, fail-soft
+ * side query over a cheap-lane alias route. Library package — no listeners,
+ * no preset mount; consumers carry their own registrations.
+ *
+ * Semantics (design doc §4): never throws; tool-call blocks rejected by
+ * default; `AbortSignal.timeout(timeoutMs)` composed with the caller's signal
+ * via `AbortSignal.any` and both aborts map to `reason: 'timeout'`;
+ * unfillable route → `'unrouted'` (with the `inherit` fallback running on the
+ * parent route); empty assembled text → `'empty'`; any other failure →
+ * `'error'`.
+ *
+ * @module @dsh-cc/side-query
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+/** Options for {@link runSideQuery}. */
+export interface SideQueryOptions {
+    /**
+     * Calling agent; REQUIRED. Route/provider fill follows the web-fetch
+     * precedent: a string-form alias needs the calling agent's requestHeader()
+     * to complete the provider half of the one-shot route.
+     */
+    agent: Agent;
+    /** Model alias consulted through ccModelRoutes/resolveAlias. Default 'haiku'. */
+    alias?: string;
+    /** System prompt for the one-shot. */
+    system?: string;
+    /** User prompt content (fully assembled by the caller). */
+    prompt: string;
+    /** Hard token budget. Default 512. */
+    maxTokens?: number;
+    /** Wall-clock budget; aborts the stream. Default 8000. */
+    timeoutMs?: number;
+    /**
+     * Caller-owned abort signal (e.g. the host plugin's effect-scope disposal);
+     * composed with the internal timeout. Never a tool-scoped exec.signal.
+     */
+    signal?: AbortSignal;
+    /**
+     * Behavior when the alias resolves to nothing (unconfigured + no parent
+     * route to inherit, or provider half cannot be completed). Default
+     * 'inherit'; 'skip' returns `{ ok: false, reason: 'unrouted' }` without
+     * touching the model.
+     */
+    onUnrouted?: 'inherit' | 'skip';
+    /** Reject results whose stream emits tool-call blocks. Default true. */
+    rejectToolCalls?: boolean;
+}
+/** Result of {@link runSideQuery}; every failure shape collapses into `ok: false`. */
+export type SideQueryResult = {
+    ok: true;
+    text: string;
+    inheritedRoute: boolean;
+    durationMs: number;
+} | {
+    ok: false;
+    reason: 'unrouted' | 'timeout' | 'error' | 'empty';
+    inheritedRoute?: boolean;
+};
+/**
+ * Run one non-streaming side query on the cheap lane (or the inherited parent
+ * route). Never throws.
+ * @param ctx - the host context (needs `llm` mounted; `ccModelRoutes` optional).
+ * @param opts - the side query declaration.
+ * @returns the assembled text, or a failure reason.
+ */
+export declare function runSideQuery(ctx: Context, opts: SideQueryOptions): Promise<SideQueryResult>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAKnD,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,KAAK,EAAE,KAAK,CAAA;IACZ,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAC/B,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,sFAAsF;AACtF,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAM/F;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+EjG"}

package/lib/index.js

@@ -0,0 +1,109 @@
+/**
+ * First-class auxiliary-LLM primitive: a one-shot, non-streaming, fail-soft
+ * side query over a cheap-lane alias route. Library package — no listeners,
+ * no preset mount; consumers carry their own registrations.
+ *
+ * Semantics (design doc §4): never throws; tool-call blocks rejected by
+ * default; `AbortSignal.timeout(timeoutMs)` composed with the caller's signal
+ * via `AbortSignal.any` and both aborts map to `reason: 'timeout'`;
+ * unfillable route → `'unrouted'` (with the `inherit` fallback running on the
+ * parent route); empty assembled text → `'empty'`; any other failure →
+ * `'error'`.
+ *
+ * @module @dsh-cc/side-query
+ */
+import { BlockAssembler, createUserMessage } from '@deepseek-ai/dsh-llm';
+import { resolveAlias, toOneShotRoute } from '@dsh-cc/model-aliases';
+const DEFAULT_ALIAS = 'haiku';
+const DEFAULT_MAX_TOKENS = 512;
+const DEFAULT_TIMEOUT_MS = 8000;
+/**
+ * Run one non-streaming side query on the cheap lane (or the inherited parent
+ * route). Never throws.
+ * @param ctx - the host context (needs `llm` mounted; `ccModelRoutes` optional).
+ * @param opts - the side query declaration.
+ * @returns the assembled text, or a failure reason.
+ */
+export async function runSideQuery(ctx, opts) {
+    const start = Date.now();
+    try {
+        const alias = opts.alias ?? DEFAULT_ALIAS;
+        const route = resolveAlias(ctx, alias);
+        // The calling agent's logged request header fills the provider half for a
+        // string-form (model-only) alias (web-fetch precedent).
+        const parent = opts.agent?.session?.requestHeader?.()?.config;
+        const filled = toOneShotRoute(route, parent);
+        let provider = filled?.provider;
+        let model = filled?.model;
+        // Builtin alias unconfigured → inherit the parent route (default), unless
+        // the caller opts out or no parent route exists to inherit.
+        const inherited = filled === undefined;
+        if (inherited) {
+            if (opts.onUnrouted === 'skip' || parent?.provider === undefined || parent?.model === undefined) {
+                return { ok: false, reason: 'unrouted' };
+            }
+            provider = parent.provider;
+            model = parent.model;
+        }
+        provider = provider ?? '';
+        model = model ?? '';
+        if (opts.signal?.aborted)
+            return { ok: false, reason: 'timeout' };
+        const timeoutSignal = AbortSignal.timeout(opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        const signal = opts.signal === undefined
+            ? timeoutSignal
+            : AbortSignal.any([timeoutSignal, opts.signal]);
+        const assembler = new BlockAssembler();
+        const options = {
+            provider,
+            model,
+            maxTokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,
+            ...(opts.system === undefined ? {} : { system: opts.system }),
+            messages: [createUserMessage({
+                    content: [{ type: 'text', text: opts.prompt }],
+                    source: { kind: 'plugin', plugin: 'side-query' },
+                })],
+            signal,
+        };
+        const consume = (async () => {
+            for await (const chunk of ctx.llm.stream(options)) {
+                assembler.push(chunk);
+            }
+        })();
+        // Dangling-stream safety: after a timeout win the dangling consume may
+        // still reject; swallow its rejection (the abort path owns the result).
+        void consume.catch(() => { });
+        const aborted = new Promise((resolve) => {
+            if (signal.aborted)
+                resolve();
+            else
+                signal.addEventListener('abort', () => resolve(), { once: true });
+        });
+        await Promise.race([consume, aborted]);
+        if (signal.aborted)
+            return { ok: false, reason: 'timeout' };
+        // The runtime normalizes an adapter throw into a terminal `finish` chunk
+        // with kind 'error'; surface it instead of misreading it as 'empty'.
+        if (assembler.finish?.kind === 'error')
+            return { ok: false, reason: 'error' };
+        // A side query that tries to act is a bug, not a capability (recall-selector
+        // rogue-execution lesson); rejectToolCalls defaults true.
+        if ((opts.rejectToolCalls ?? true)
+            && (assembler.finish?.kind === 'tool-calls'
+                || assembler.blocks().some(block => block.type === 'tool-call'))) {
+            return { ok: false, reason: 'error' };
+        }
+        const text = assembler.blocks()
+            .filter(block => block.type === 'text')
+            .map(block => block.text)
+            .join(' ')
+            .trim();
+        if (text.length === 0)
+            return { ok: false, reason: 'empty' };
+        return { ok: true, text, inheritedRoute: inherited, durationMs: Date.now() - start };
+    }
+    catch {
+        return { ok: false, reason: 'error' };
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@dsh-cc/side-query",
+  "description": "First-class auxiliary-LLM primitive: one-shot, non-streaming, fail-soft side query over a cheap-lane alias route with timeout/tool-call rejection/unrouted semantics",
+  "version": "0.8.0-rc.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsh-cc/dsh-cc.git",
+    "directory": "packages/llm-tuning/side-query"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-agent": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.1",
+    "@dsh-cc/model-aliases": "^0.8.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/dsh-agent": "link:../../../../deepseek-harness/packages/core/agent",
+    "@deepseek-ai/dsh-llm": "link:../../../../deepseek-harness/packages/llm/llm",
+    "vitest": "^4.1.8",
+    "@dsh-cc/model-aliases": "^0.8.0-rc.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}