@ai-matrx/agents 0.17.4 → 0.18.1

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # Changelog
 
+## 0.18.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/matrx-agents/v0.17.5..npm/matrx-agents/v0.18.1 -- apps/shared/matrx-agents`).
+No source changes intended and no consumer action required.
+
+## 0.18.0
+
+### Added
+
+- `./sources/runtime` — the Source input's UI-free core (common-docs
+  `projects/unified-source-input/DESIGN.md` § "One core, many screens", item
+  USI-7), moved out of the web app: source-list reducers + selectors
+  (drafts, per-Source status, delivery / forms / parts / caps, host config:
+  allowed deliveries and max), `createSourceSetController` over an injected
+  store, draft storage, client and config; `createSourceIntake` (paste, web
+  page, YouTube, recording, upload, existing) with every door, the
+  organization gate and the wording injected; recovery (`resumeInterrupted`,
+  `continueAfterOrganization`, `lookAtFileCards`); THE review planner
+  `planSourceReview` (estimator injectable, default the measured 2.9
+  chars/token); `createSourcesClient` for `/sources/manifest`, `/sources/resolve`
+  and `/sources/parts/search` (always sent as organization-free reads) plus
+  `createFetchSourcesTransport` for clients without an API layer; the pure
+  rules `delivery`, `partsSearch`, `interrupted`, `fileSource`.
+- `./sources/react` — `useSourceSet(adapter)`, `useSourceIntake`,
+  `useSourceRecovery`, `useSourcePartsSearch`.
+
+### Consumer action
+
+- matrx-frontend: bind the adapter to Redux `instanceResources` + `wizardDraft`
+  in `features/resource-manager/source-input/useSourceSet.ts`, bind the intake
+  doors (sourcesApi, scraper, YouTube reader, transcription, associations
+  service, organization gate) in `useSourceIntake.ts`, the file-state read in
+  `useSourceRecovery.ts`, and the typed `apiPost` transport in
+  `sourceSetApi.ts`; delete the local `delivery.ts`, `partsSearch.ts`,
+  `interrupted.ts`, `fileSource.ts`, `useSourcePartsText.ts` and
+  `review/plan.ts`, importing them from `@ai-matrx/agents/sources/runtime`.
+  Other consumers: none — additive.
+
+## 0.17.5
+### Unreleased
+
+### Added
+
+- `./sources` contract amendment A5 (common-docs
+  `projects/unified-source-input/DESIGN.md` § Contract amendments):
+  `SourceManifestSegment` gains optional `preview` (a part's opening words,
+  never its body); a part spanning several pages is labelled "Pages 22–24".
+
+### Consumer action
+
+- None — additive. Show `preview` under a part and match searches against it.
+
 ## 0.17.4
 ### Unreleased
 

package/README.md

@@ -208,6 +208,41 @@ is hidden, never dead).
 `agx_get_list_full`, `agx_search`, `agx_resolve_agent_address` and
 `ues_get_bulk` (the star read).
 
+## The one Source input (`./sources`, `./sources/runtime`, `./sources/react`)
+
+`./sources` is the wire contract (`SourceRef`, `SourceSet`, `SourceManifest`,
+`ResolvedSourceSet`). `./sources/runtime` is the UI-free core every screen of
+the Source input sits on — pure TypeScript, with every outside dependency
+injected:
+
+```ts
+import {
+  createSourceSetController,
+  createSourceIntake,
+  createSourcesClient,
+  createFetchSourcesTransport,
+  createMemorySourceSetStore,
+  planSourceReview,
+} from "@ai-matrx/agents/sources/runtime";
+
+const client = createSourcesClient(
+  createFetchSourcesTransport({ baseUrl, headers: async () => ({ Authorization: `Bearer ${token}` }) }),
+);
+const set = createSourceSetController({
+  store: createMemorySourceSetStore(), // or your own store adapter
+  client,
+  config: { defaultForm: "clean", deliveries: ["direct"], max: 5 },
+});
+const intake = createSourceIntake(set, { doors, ensureOrganization, /* … */ });
+await intake.addPastedText(text, "Chapter 8 notes");
+await set.manifest(); // sizes, forms, parts on each card
+const plan = planSourceReview({ manifest, refs, base: set.toSourceSet(), modelWindowTokens, fallbackWindowTokens });
+const grounded = await set.resolve();
+```
+
+`./sources/react` binds it: `useSourceSet(adapter)`, `useSourceIntake(set, deps)`,
+`useSourceRecovery(set, intake, runner, options)`, `useSourcePartsSearch(client, ref, query)`.
+
 ## Runtime support
 
 The package targets modern browsers, browser-based desktop shells,
@@ -215,7 +250,7 @@ extensions, Next.js client or server modules, and Node 20+. Its one runtime
 dependencies are `@ai-matrx/data` (the shared net-resilience + credentials
 layer), `@ai-matrx/design-system` (the picker's primitives) and
 `@ai-matrx/associations` (the per-user star chokepoint); `react >= 18`
-is an optional peer needed only by `./react` and `./catalog/react`. No entry
+is an optional peer needed only by `./react`, `./sources/react` and `./catalog/react`. No entry
 point performs work at import time.
 
 ## Development