@atrib/summarize 0.3.0 → 0.3.2

package/LICENSE

@@ -1,3 +1,4 @@
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -32,9 +33,10 @@
       not limited to compiled object code, generated documentation,
       and conversions to other media types.
 
-      "Work" shall mean the work of authorship 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).
+      "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
@@ -44,21 +46,23 @@
       separable from, or merely link (or bind by name) to the interfaces of,
       the Work and Derivative Works thereof.
 
-      "Contribution" shall mean, as submitted to the 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 Legal Entity on behalf of
-      whom a Contribution has been received by the Licensor and subsequently
-      incorporated within the Work.
+      "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,
@@ -76,19 +80,20 @@
       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.
+      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
+      (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
@@ -100,8 +105,10 @@
           the Derivative Works; and
 
       (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, You must include a readable copy of the attribution
-          notices contained within such NOTICE file, in at least one
+          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,
@@ -114,9 +121,12 @@
           that such additional attribution notices cannot be construed
           as modifying the License.
 
-      You may add Your own license statement for Your modifications and
-      may provide additional grant of rights to use, modify, or distribute
-      those modifications in accordance with this 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
@@ -138,7 +148,7 @@
       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 reproducing the Work and assume any
+      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,
@@ -146,12 +156,12 @@
       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 exemplary damages of any character arising as a
+      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 all other
-      commercial damages or losses), even if such Contributor has been
-      advised of the possibility of such damages.
+      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,
@@ -172,8 +182,24 @@
       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 in question. Also, an optional
-      "Statement of Purpose" appears after the copyright notice.
+      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.
 
    Copyright 2025-2026 Atrib contributors
 

package/README.md

@@ -1,6 +1,6 @@
 # @atrib/summarize
 
-MCP server exposing the `summarize` tool — synthesizes a narrative across N records using an OpenAI-compatible LLM.
+MCP server exposing the `summarize` tool, synthesizes a narrative across N records using an OpenAI-compatible LLM.
 
 Closes the consumer-side cognitive-loop primitive companion to `atrib-trace`: trace returns the causal chain (structural); summarize returns the synthesized meaning across the chain (semantic). Both read the same local mirror including the optional `_local` sidecar.
 
@@ -39,13 +39,13 @@ OpenAI-compatible HTTP. Defaults to NVIDIA NIM with `qwen/qwen3.5-397b-a17b`. Ov
 | `ATRIB_SUMMARIZE_TEMPERATURE` | `0.3` |
 | `ATRIB_SUMMARIZE_TIMEOUT_MS` | `120000` |
 
-Without an API key, the tool returns a warnings-only response per the [§5.8](../../atrib-spec.md#58-degradation-contract) graceful-degradation contract.
+Without an API key, the tool returns a warnings-only response per the [§5.8](https://github.com/creatornader/atrib/blob/main/atrib-spec.md#58-degradation-contract) graceful-degradation contract.
 
 ## Reads
 
 Same as `@atrib/trace`: every `*.jsonl` mirror under `~/.atrib/records/` (override via `ATRIB_RECORDS_DIR`). Tolerates both legacy bare-record and current envelope shapes.
 
-When a record lacks a `_local` sidecar (legacy entry), the prompt includes a marker telling the LLM the input is impoverished — only event_type + cryptographic metadata is available — so the synthesis can be honest about gaps. The output reports `records_with_sidecar` and `records_without_sidecar` counts so callers know how rich the input was.
+When a record lacks a `_local` sidecar (legacy entry), the prompt includes a marker telling the LLM the input is impoverished, only event_type + cryptographic metadata is available, so the synthesis can be honest about gaps. The output reports `records_with_sidecar` and `records_without_sidecar` counts so callers know how rich the input was.
 
 ## Behaviors
 

package/dist/index.js

@@ -16,6 +16,7 @@
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
+import { resolveEnvContextId } from '@atrib/mcp';
 import { loadAllRecords } from './storage.js';
 import { callLlm, resolveLlmConfig } from './llm.js';
 import { buildSystemPrompt, buildUserMessage } from './prompt.js';
@@ -31,7 +32,7 @@ const SummarizeInput = z.object({
         'general "summarize what the agent did and why" focus.'),
     max_records: z.number().int().min(1).max(200).optional().describe('Cap on records fed to the LLM, default 50. Records beyond the cap (after ' +
         'sorting by timestamp ascending) are skipped and counted in records_skipped. ' +
-        'Increase carefully — large prompts run slower + cost more + risk model ' +
+        'Increase carefully, large prompts run slower + cost more + risk model ' +
         'context limits.'),
     model: z.string().min(1).max(200).optional().describe('Override the configured model for this call. Format depends on provider ' +
         '(NVIDIA NIM uses e.g. "qwen/qwen3.5-397b-a17b"). Defaults to env ' +
@@ -59,14 +60,11 @@ export async function createAtribSummarizeServer() {
 async function handleSummarize(input) {
     const warnings = [];
     const maxRecords = input.max_records ?? 50;
-    // ATRIB_CONTEXT_ID env-var default: when the caller omitted context_id
-    // AND did not supply record_hashes, fall back to the env var if it
-    // carries a valid 32-hex value. Lets Inspect-style harnesses scope
-    // summarize to a per-arm context_id via the MCP env block (per D072's
-    // per-arm isolation contract). Explicit input.context_id always wins.
-    const envContextId = process.env['ATRIB_CONTEXT_ID'];
-    const effectiveContextId = input.context_id ??
-        (envContextId && HEX_32_PATTERN.test(envContextId) ? envContextId : undefined);
+    // Env-var context_id default: when the caller omitted context_id AND did
+    // not supply record_hashes, fall back to @atrib/mcp's resolveEnvContextId
+    // (D078 + D083 precedence: ATRIB_CONTEXT_ID, then a registered harness
+    // env var like CLAUDE_CODE_SESSION_ID). Explicit input.context_id wins.
+    const effectiveContextId = input.context_id ?? resolveEnvContextId();
     const effective = {
         ...input,
         ...(effectiveContextId ? { context_id: effectiveContextId } : {}),
@@ -166,6 +164,6 @@ function emptyOutput(warnings) {
         warnings,
     };
 }
-// Test-only export — lets unit tests exercise the assembly logic without
+// Test-only export, lets unit tests exercise the assembly logic without
 // going through the McpServer transport.
 export const __test_only__ = { handleSummarize, selectRecords };

package/dist/prompt.js

@@ -13,7 +13,7 @@ Your job: produce a coherent narrative across the records that surfaces:
 - Honest gaps (when records are impoverished, say so; do not invent semantics)
 
 Cite specific records by short hash (first 12 chars of record_hash) when making claims.
-Be concise. The reader is the same agent that signed these records — assume they want to be reminded, not lectured.`;
+Be concise. The reader is the same agent that signed these records, assume they want to be reminded, not lectured.`;
 export function buildSystemPrompt() {
     return SYSTEM_PROMPT;
 }
@@ -89,7 +89,7 @@ function renderRecord(r) {
             out.push(`result (truncated): ${JSON.stringify(sc.result).slice(0, 300)}`);
     }
     else {
-        out.push('(no semantic sidecar available — record predates local-mirror sidecar pattern; only cryptographic metadata is present)');
+        out.push('(no semantic sidecar available, record predates local-mirror sidecar pattern; only cryptographic metadata is present)');
     }
     return out.join('\n');
 }

package/dist/storage.d.ts

@@ -15,7 +15,7 @@ export interface IndexedRecord {
     local?: SidecarPayload;
 }
 /**
- * Combined sidecar shape — superset of every producer's local payload
+ * Combined sidecar shape, superset of every producer's local payload
  * (mcp-wrap writes toolName/args/result; atrib-emit writes content).
  */
 export interface SidecarPayload extends OnRecordSidecar {

package/dist/storage.js

@@ -60,7 +60,7 @@ export function loadAllRecords(dir = RECORDS_DIR) {
                         source: fname,
                     };
                     // Lift the `_local` sidecar onto the indexed record when present.
-                    // Legacy bare-record entries have no sidecar; that's OK — consumers
+                    // Legacy bare-record entries have no sidecar; that's OK, consumers
                     // tolerate its absence.
                     if (isEnvelope) {
                         const sidecar = parsed._local;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atrib/summarize",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "MCP server for atrib. Synthesizes a narrative across N records via an OpenAI-compatible LLM so agents read context, not raw record bytes.",
   "license": "Apache-2.0",
   "type": "module",
@@ -11,13 +11,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76",
-    "@atrib/mcp": "0.6.2"
+    "@atrib/mcp": "0.8.0"
   },
   "devDependencies": {
-    "@types/node": "^22.19.17",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "@types/node": "^25.8.0",
+    "tsx": "^4.22.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
   },
   "files": [
     "dist"
@@ -25,6 +25,11 @@
   "publishConfig": {
     "access": "public"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/creatornader/atrib.git",
+    "directory": "services/atrib-summarize"
+  },
   "scripts": {
     "build": "rm -rf dist && tsc",
     "start": "node dist/main.js",