langfx.js 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.md

@@ -2,10 +2,27 @@
 
 Language as functions, in TypeScript. Build agents in browsers, workers, and apps without a Python agent backend.
 
-**Status: alpha (`0.1.0-alpha.1`).** OpenAI, Anthropic, and Gemini support text/image inputs, client tools, and streaming tool events through fixture-tested transports. The runtime includes prompt composition, structured JSON streaming, bounded agents, invocation traces/logs/progress, retries, and local response caching. Gemini has passed the live smoke suite; live OpenAI/Anthropic behavior and provider browser CORS remain unverified. APIs may change during alpha. See [implementation status](docs/IMPLEMENTATION_STATUS.md) and the [opt-in live smoke runner](docs/LIVE_TESTING.md).
+**Status: alpha (`0.1.0-alpha.3`).** OpenAI, Anthropic, and Gemini support text/image inputs, client tools, and streaming tool events through fixture-tested transports. The runtime includes prompt composition, structured JSON streaming, bounded agents, invocation traces/logs/progress, retries, and local response caching. Gemini has passed the live smoke suite; live OpenAI/Anthropic behavior and provider browser CORS remain unverified. APIs may change during alpha. See [implementation status](docs/IMPLEMENTATION_STATUS.md) and the [opt-in live smoke runner](docs/LIVE_TESTING.md).
 
 The proposal is based on [`free-solo/langfx`](https://github.com/free-solo/langfx) at commit `2a1ea4e8dcd7075bf745ad707f901ece8546f47d`, examined on September 16, 2026.
 
+Try the [npm quickstart](https://github.com/free-solo/langfx.js/blob/main/examples/npm-quickstart/README.md) for a credentials-free nested-class query using the published package.
+
+## Agents inside your app
+
+Declare model-generated values with `lf.typed.Class`, give action classes application-owned dependencies, and execute validated instances through `lf.Session`. Your application controls when those actions run.
+
+| Example | What it demonstrates | Run from this repository |
+| --- | --- | --- |
+| [Board agent](examples/board-agent/README.md) | Typed edits, before/after preview, explicit approval, atomic apply, and undo | `npm run example:board` |
+| [Search agent](examples/search-agent/README.md) | Multi-step actions, real web search over MCP, streamed answers, and cancellation | `npm run example:search` |
+
+For React, try the [standalone React board](examples/react-board/README.md), which installs the published package with its own dependencies. See [integration findings](docs/REACT_INTEGRATION.md) for what is tested and what the app still owns.
+
+Both use real Gemini inference and a local credential gateway. See [App actions and approval](docs/APP_ACTIONS.md) to adapt the board example to your own application. Approval and undo are implemented by the example; the core provides typed generation and action execution.
+
+To try preview, approval, and undo without credentials, run `npm run example:approval` after `npm ci`. This terminal walkthrough uses a clearly labeled fixed test response and the same board actions; it makes no API requests.
+
 ## Install the alpha
 
 Install with `npm install langfx.js@alpha`. Zod users also install `zod`; the core has no runtime dependencies. See [release notes and publishing procedure](docs/RELEASING.md).
@@ -22,28 +39,28 @@ npm run example:agent
 npm run serve:example
 ```
 
-For a complete browser app with live web search over MCP, streamed answers, cancellation, and simulated failures, run `npm run example:app`. See [Search agent](examples/app/README.md) for setup and live-model integration.
+For a complete browser app with live web search over MCP, streamed answers, cancellation, and simulated failures, run `npm run example:search`. See [Search agent](examples/search-agent/README.md) for setup and live-model integration.
 
 `npm run serve:example` serves the browser/worker example at `http://127.0.0.1:8765`. No credentials or Python runtime are needed. Fake models are imported separately from the core:
 
 ```ts
 import * as lf from 'langfx.js';
 import { Echo, StaticResponse } from 'langfx.js/testing';
-import { fromZod } from 'langfx.js/schema/zod';
-import { z } from 'zod';
+const t = lf.typed;
 
 const lm = new Echo();
 console.log(await lf.query('Hello {{name}}!', { lm, vars: { name: 'Ada' } }));
 
-const Answer = fromZod(z.object({ answer: z.number() }));
+class Answer extends t.Class({ answer: t.int }) {}
 const result = await lf.query('What is 1 + 1?', Answer, {
-  protocol: 'json',
-  lm: new StaticResponse('{"answer":2}'),
+  lm: new StaticResponse('Answer(answer=2)'),
 });
-console.log(result.answer);
+console.log(result.answer); // 2; result is an Answer instance.
 ```
 
-The core has no runtime package dependencies. Zod is an optional peer used only by `langfx.js/schema/zod`; it is included in this checkout's development dependencies. Model calls remain asynchronous even for these deterministic fake models.
+`t.Class` derives typed members and a constructor from the field declarations. Pass the class directly to `lf.query`; the default Python-style protocol validates constructor-shaped data and returns a class instance without executing Python. Nested fields and lists can also use classes directly. See [Classes and schemas](docs/CLASS_SCHEMAS.md).
+
+The core has no runtime package dependencies. Zod remains optional through `langfx.js/schema/zod` with `protocol: 'json'`. Model calls remain asynchronous even for these deterministic fake models.
 
 ## Recommended scope
 
@@ -69,16 +86,17 @@ import * as lf from 'langfx.js';
 const lm = new lf.llms.Gemini({ model: modelId, transport });
 const answer = await lf.query('What is 1 + 1?', { lm });
 
-// ImageDescription is an explicitly declared JSON runtime schema.
+const t = lf.typed;
+class ImageDescription extends t.Class({ items: t.list(t.str) }) {}
 const desc = await lf.query(
   'Describe objects in {{image}}.',
   ImageDescription,
-  { lm, protocol: 'json', vars: { image: lf.Image.fromFile(file) } },
+  { lm, vars: { image: lf.Image.fromFile(file) } },
 );
 console.log(desc.items); // Typed value, just like Python lf.query.
 ```
 
-`modelId`, `transport`, `file`, and the schema are supplied by the application. Provider classes extend `LanguageModel`; there is no required client/factory layer. Keep `Template`, `LangFunc`, message/modality classes, `Action`, and `Session`, including subclass extension points. Basic `{{name}}` templates are supported in the proposal; full Jinja is not.
+`modelId`, `transport`, and `file` are supplied by the application. Provider classes extend `LanguageModel`; there is no required client/factory layer. Keep `Template`, `LangFunc`, message/modality classes, `Action`, and `Session`, including subclass extension points. Basic `{{name}}` templates are supported in the proposal; full Jinja is not.
 
 The main differences are explicit `new`/options objects, async I/O, camelCase multiword names, and runtime schema declarations. Use `lm.call(...)` for Python's callable model objects and `action.invoke(session)` for Python's action invocation wrapper. See the [API mapping](docs/API_DESIGN.md) for details.
 
@@ -90,6 +108,7 @@ Local operations such as `Template.render()`, schema validation, and message con
 
 ## Design documents
 
+- [App actions and approval](docs/APP_ACTIONS.md): turn typed plans into previewed, approved application edits with local undo.
 - [Gemini and tools](docs/GEMINI.md): adapter setup, registered app tools, and current verification limits.
 - [Porting plan](docs/PORTING_PLAN.md): feature decisions, runtime boundaries, implementation order, and release gates.
 - [Source audit](docs/SOURCE_AUDIT.md): implementation findings and test cases to carry forward, with pinned source links.

package/dist/agentic.d.ts

@@ -1,7 +1,8 @@
-import type { QueryOptions, QueryValue } from './query.js';
+import type { QueryOptions, QueryValue, StructuredQueryStreamOptions } from './query.js';
+import type { StructuredStreamEvent } from './json-stream.js';
 import type { SchemaLike, SchemaValue, CheckedSchema } from './schema.js';
 import type { Prompt } from './template.js';
-import type { LanguageModel, SamplingUsage } from './language-model.js';
+import type { LanguageModel, SamplingUsage, StreamChunk } from './language-model.js';
 export interface RunOptions {
     readonly lm?: LanguageModel;
     readonly signal?: AbortSignal;
@@ -15,6 +16,11 @@ export interface SessionOptions extends RunOptions {
 export type SessionQueryOptions = Omit<QueryOptions, 'lm'> & {
     readonly lm?: LanguageModel;
 };
+export type SessionStructuredQueryStreamOptions = Omit<StructuredQueryStreamOptions, 'lm'> & RunOptions;
+export type SessionTextQueryStreamOptions = Omit<SessionQueryOptions, 'returnsMessage' | 'nativeStructuredOutput'> & RunOptions & {
+    readonly returnsMessage?: never;
+    readonly nativeStructuredOutput?: never;
+};
 export type LogLevel = 'debug' | 'info' | 'warning' | 'error' | 'fatal';
 export interface LogOptions {
     readonly keep?: boolean;
@@ -109,6 +115,8 @@ export declare class Session {
     query<S extends SchemaLike<unknown>, O extends SessionQueryOptions>(prompt: Prompt, schema: S & CheckedSchema<NoInfer<S>>, options: O): Promise<QueryValue<SchemaValue<S>, O>>;
     query<S extends SchemaLike<unknown>>(prompt: Prompt, schema: S & CheckedSchema<NoInfer<S>>): Promise<SchemaValue<S>>;
     query<O extends SessionQueryOptions = {}>(prompt: Prompt, options?: O): Promise<QueryValue<string, O>>;
+    queryStream<S extends SchemaLike<unknown>>(prompt: Prompt, schema: S & CheckedSchema<NoInfer<S>>, options?: SessionStructuredQueryStreamOptions): AsyncIterable<StructuredStreamEvent<SchemaValue<S>>>;
+    queryStream(prompt: Prompt, options?: SessionTextQueryStreamOptions): AsyncIterable<StreamChunk>;
     concurrentMap<I, O>(inputs: readonly I[], fn: (input: I, branch: Session) => Promise<O>, options?: {
         readonly maxConcurrency?: number;
     }): Promise<O[]>;

package/dist/agentic.js

@@ -1,6 +1,6 @@
 import { abortable, cancellationScope, checkCancelled } from './cancellation.js';
 import { CancelledError, SessionClosedError } from './errors.js';
-import { query } from './query.js';
+import { query, queryStream } from './query.js';
 let serial = 0;
 function trace(kind, name, parentId) {
     return { id: `invocation-${++serial}`, parentId, kind, name, status: 'running', startedAt: Date.now(), endedAt: undefined, result: undefined, error: undefined, usage: undefined, metadata: Object.freeze({}), logs: [], progress: undefined, children: [] };
@@ -119,6 +119,185 @@ export class Session {
             return config.returnsMessage ? response : response.result;
         }, config);
     }
+    queryStream(prompt, schemaOrOptions = {}, options) {
+        const isSchema = typeof schemaOrOptions === 'function' || 'schema' in schemaOrOptions || 'parse' in schemaOrOptions;
+        const schema = isSchema ? schemaOrOptions : undefined;
+        const config = (isSchema ? options : schemaOrOptions) ?? {};
+        let node;
+        let scope;
+        let source;
+        let closing;
+        let completion;
+        let complete;
+        let terminal;
+        let failure;
+        let hasFailure = false;
+        let delivered = false;
+        let ended = false;
+        let serial = Promise.resolve();
+        const owner = this;
+        const onAbort = () => {
+            try {
+                checkCancelled(scope.signal);
+            }
+            catch (error) {
+                void finish('cancelled', error);
+            }
+        };
+        // Close independently of demand: dispose/deadlines must also close a paused stream.
+        const finish = (status, error, value) => {
+            if (closing)
+                return closing;
+            closing = Promise.resolve().then(async () => {
+                scope.signal.removeEventListener('abort', onAbort);
+                if (status !== 'completed')
+                    scope.abort(error);
+                try {
+                    await source?.return?.();
+                }
+                catch (cleanupError) {
+                    if (status === 'completed') {
+                        status = 'failed';
+                        error = cleanupError;
+                        value = undefined;
+                    }
+                }
+                if (status === 'completed' && scope.signal.aborted) {
+                    try {
+                        checkCancelled(scope.signal);
+                    }
+                    catch (cancelled) {
+                        status = 'cancelled';
+                        error = cancelled;
+                        value = undefined;
+                    }
+                }
+                node.status = status;
+                if (status === 'completed') {
+                    if (value && 'type' in value && value.type === 'generationComplete') {
+                        node.result = value.result;
+                        node.usage = value.usage;
+                    }
+                    else if (value && 'isFinal' in value) {
+                        node.result = value.aggregated.text;
+                        node.usage = value.usage;
+                    }
+                    terminal = value;
+                }
+                else {
+                    node.error = error;
+                    if (schema)
+                        terminal = value && 'type' in value && 'error' in value ? value
+                            : { type: status === 'cancelled' ? 'cancelled' : 'generationFailed', error };
+                    else {
+                        failure = error;
+                        hasFailure = true;
+                    }
+                }
+                scope.dispose();
+                node.endedAt = Date.now();
+                owner.emit('end', node);
+                owner.store.pending.delete(completion);
+                owner.operations.delete(completion);
+                complete();
+            });
+            return closing;
+        };
+        const start = () => {
+            owner.assertOpen();
+            if (owner.store.nodes >= owner.store.limit)
+                throw new RangeError('Session trace limit reached. Start a new session or increase maxTraceNodes.');
+            scope = cancellationScope([owner.signal, config.signal], config.maxExecutionTime);
+            node = trace('query', 'queryStream', owner.node.id);
+            owner.store.nodes++;
+            owner.node.children.push(node);
+            completion = new Promise(resolve => { complete = resolve; });
+            owner.store.pending.add(completion);
+            owner.operations.add(completion);
+            scope.signal.addEventListener('abort', onAbort, { once: true });
+            owner.emit('start', node);
+        };
+        const finalResult = () => {
+            if (delivered || ended)
+                return { done: true, value: undefined };
+            delivered = true;
+            if (hasFailure)
+                throw failure;
+            return terminal ? { done: false, value: terminal } : { done: true, value: undefined };
+        };
+        const advance = async () => {
+            if (ended || delivered)
+                return { done: true, value: undefined };
+            if (!node) {
+                start();
+                try {
+                    checkCancelled(scope.signal);
+                    const lm = config.lm ?? owner.lm;
+                    if (!lm)
+                        throw new TypeError('Session.queryStream requires a LanguageModel.');
+                    const full = { ...config, lm, signal: scope.signal };
+                    source = (schema ? queryStream(prompt, schema, full) : queryStream(prompt, full))[Symbol.asyncIterator]();
+                }
+                catch (error) {
+                    await finish(error instanceof CancelledError ? 'cancelled' : 'failed', error);
+                    return finalResult();
+                }
+            }
+            if (closing) {
+                await closing;
+                return finalResult();
+            }
+            try {
+                const next = await source.next();
+                if (closing) {
+                    await closing;
+                    return finalResult();
+                }
+                checkCancelled(scope.signal);
+                if (next.done)
+                    throw new Error('Query stream ended without a terminal event.');
+                const value = next.value;
+                if ('type' in value) {
+                    if (value.type === 'generationComplete')
+                        await finish('completed', undefined, value);
+                    else if ('error' in value)
+                        await finish(value.type === 'cancelled' ? 'cancelled' : 'failed', value.error, value);
+                    else
+                        return { done: false, value };
+                }
+                else if (value.isFinal)
+                    await finish('completed', undefined, value);
+                else
+                    return { done: false, value };
+            }
+            catch (error) {
+                await finish(error instanceof CancelledError ? 'cancelled' : 'failed', error);
+            }
+            return finalResult();
+        };
+        // A single-use iterator, like the model stream. Serialize concurrent next() calls.
+        const iterator = {
+            [Symbol.asyncIterator]() { return this; },
+            next() {
+                const next = serial.then(advance);
+                serial = next.catch(() => { });
+                return next;
+            },
+            async return() {
+                ended = true;
+                if (node)
+                    await finish('cancelled', new CancelledError('Stream consumer stopped early.'));
+                return { done: true, value: undefined };
+            },
+            async throw(error) {
+                ended = true;
+                if (node)
+                    await finish(error instanceof CancelledError ? 'cancelled' : 'failed', error);
+                throw error;
+            },
+        };
+        return iterator;
+    }
     async concurrentMap(inputs, fn, options = {}) {
         const concurrency = options.maxConcurrency ?? 4;
         if (!Number.isInteger(concurrency) || concurrency < 1)

package/dist/agentic.js.map

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

package/docs/APP_ACTIONS.md

@@ -0,0 +1,101 @@
+# Let an agent edit application state
+
+Use typed actions when a model should propose changes to your application: moving tasks, editing a document, or adjusting a configuration. The model supplies validated fields; your application supplies the objects that those actions can operate on and decides when to execute them.
+
+The [board-agent example](../examples/board-agent/README.md) demonstrates the complete flow with real Gemini inference. Run `npm run example:board` from the repository after setting `GEMINI_API_KEY` or `GOOGLE_API_KEY`.
+
+To try the mechanics without credentials, run `npm run example:approval` after `npm ci`. This terminal walkthrough uses an explicitly fixed test response with the same board actions. It shows the proposed changes and waits for `y` before applying them, then demonstrates undo. Any other answer discards the proposal. It makes no API requests and does not test model quality.
+
+## The application owns approval
+
+```text
+Request + board snapshot → typed plan → validate and preview
+                                            ↓
+                                      user approval
+                                            ↓
+                               invoke actions on a draft
+                                            ↓
+                              check revision → commit once
+                                            ↓
+                                   optional local undo
+```
+
+`lf.query` generates and validates class instances. It does not invoke their actions. `lf.Action` and `lf.Session` supply execution and tracing; preview, approval, transactions, and undo are application code in this example, not built-in framework guarantees.
+
+## Declare the edits the model may propose
+
+This excerpt uses the example's `BoardDraft`, a mutable copy of board data with methods that validate task IDs and titles:
+
+```ts
+import * as lf from 'langfx.js';
+import { BoardDraft } from './board.js';
+const t = lf.typed;
+
+abstract class BoardAction extends lf.Action<void> {
+  constructor(private readonly draft: BoardDraft) { super(); }
+  abstract applyTo(draft: BoardDraft): void;
+  override async call(): Promise<void> { this.applyTo(this.draft); }
+}
+
+class MoveTask extends t.Class(BoardAction, {
+  taskId: t.str,
+  status: t.literal('todo', 'doing', 'done'),
+}) {
+  static readonly schemaName = 'MoveTask';
+  applyTo(draft: BoardDraft): void {
+    draft.move(this.taskId, this.status);
+  }
+}
+```
+
+The generated constructor takes the fields first and forwards remaining arguments to `BoardAction`. `schemaName` keeps the model-facing name stable if the app bundle is minified. Constructors must only initialize state: schema validation can instantiate candidates, including candidates in a union.
+
+Bind the application dependency with `t.schemaFrom`. In the example's planning function, `draft` is a fresh copy of the current board:
+
+```ts
+const actionSchema = t.union(
+  t.schemaFrom(MoveTask, draft),
+  t.schemaFrom(RenameTask, draft),
+  t.schemaFrom(AddTask, draft),
+);
+class Plan extends t.Class({
+  summary: t.str,
+  changes: t.list(actionSchema, { minSize: 1, maxSize: 8 }),
+}) {
+  static readonly schemaName = 'Plan';
+}
+```
+
+`RenameTask` and `AddTask` follow the same pattern in [actions.ts](../examples/board-agent/actions.ts). The model generates fields such as `taskId` and `status`; it cannot supply or replace the bound `draft`. Pass `Plan` directly to `session.query`. No explicit schema conversion is needed for a class without bound dependencies.
+
+## Preview the exact changes before execution
+
+Capture a board snapshot and its revision before querying. After generation, reject a result if the request was cancelled or the board revision changed.
+
+Apply the returned actions to a separate preview draft with `change.applyTo(preview)`. This performs domain validation without editing the live board or invoking actions. Show the resulting before/after boards, not just the model's summary: the summary is generated text and may misdescribe the edits.
+
+Keep the parsed actions and their execution draft private to the pending proposal. Return copies of preview data to the UI. Approval must execute the same action instances that produced the preview, rather than asking the model to generate another plan.
+
+The preview method must be deterministic and confined to the supplied draft. It must not make network calls, mutate shared state, or depend on changing external data. Both preview and execution use this method, so their results agree for the same starting state.
+
+## Approve, apply, or discard
+
+The example's `Proposal.approve` creates a new execution session only after the user clicks **Approve and apply**. It checks the starting revision, invokes each action with `await action.invoke(session)`, checks cancellation, and commits the draft with the expected revision. A `finally` block disposes the session.
+
+The final revision check is essential even if approval checked it already: another edit can occur while an action is awaited. The store publishes the complete draft in one synchronous commit, so an invalid action, cancellation, or stale revision leaves the live board unchanged. Discarding a pending proposal invokes nothing. A proposal cannot be applied twice, and failed proposals must be regenerated.
+
+The UI disables competing controls while a request runs, but the data layer also enforces these rules independently. See [main.ts](../examples/board-agent/main.ts) for event handlers and [board.ts](../examples/board-agent/board.ts) for commit checks.
+
+## Undo and persistence boundaries
+
+Before committing, the store saves the previous board, including its ID counter. Undo restores it and increments the revision, invalidating proposals made against the later state. This example retains one undo entry and keeps everything in the current browser tab; refreshing resets the board.
+
+This transaction pattern covers local state. It does not undo a sent email, payment, or remote API write. For external effects, put authorization and concurrency checks at the service that owns the data, and define idempotency and any compensating operations there. Browser approval is an interaction pattern, not a server authorization boundary.
+
+## Adapt and test the pattern
+
+For another app, replace `BoardDraft` with your domain operations, declare the allowed action classes, and supply a store that can reject commits against an outdated revision. Keep model transport credentials in the host's gateway, as the example does; task titles and requests are still sent to the inference provider.
+
+The [regression tests](../tests/board-agent.test.mjs) use deterministic model responses to cover preview isolation, invalid plans, discard, duplicate approval, cancellation between actions, concurrent edits during planning and execution, and undo invalidation. Run them with `node --test tests/board-agent.test.mjs`.
+
+For an agent that gathers information across repeated model turns, see the [search agent](../examples/search-agent/README.md). For field types, nested classes, unions, inheritance, and custom constructors, see [Classes and schemas](CLASS_SCHEMAS.md).

package/docs/CI.md

@@ -0,0 +1,10 @@
+# Continuous integration
+
+[Checks](../.github/workflows/check.yml) runs on pull requests, pushes to `main`, and manual dispatch. It uses read-only repository permissions and does not receive model credentials or publish packages.
+
+- **Core (Node 22)** and **Core (Node 24)** install the root lockfile with `npm ci` and run `npm run check`: typechecking, tests, browser checks, captured Python parity fixtures, schema/streaming regression checks, and isolated packed-package checks. No Python checkout or live inference is needed.
+- **Published package in React** installs only `examples/react-board` and runs its `npm run check`. This verifies the pinned npm release rather than the PR's library source, keeping release-consumer compatibility distinct from core checks.
+
+GitHub Actions are pinned by commit. npm caches use each job's lockfile. New runs cancel superseded runs for the same ref, and jobs have time limits.
+
+These checks report results on PRs; required-check enforcement is a separate repository branch-protection setting. Live model smoke tests remain opt-in as described in [Live testing](LIVE_TESTING.md).

package/docs/CLASS_SCHEMAS.md

@@ -294,7 +294,7 @@ Parsing `Search(query="local AI agents")` constructs `new Search({ query: 'local
 
 For an action with no generated fields, declare `static fields = {}` and accept an empty first constructor argument. For example, `schemaFrom(Finish, options, observations)` constructs `new Finish({}, options, observations)` when the model returns `Finish()`.
 
-Constructors must only initialize state: union validation may construct candidate instances. Put network requests and other effects in `call`, then invoke the validated action separately. See the [search-agent actions](../examples/app/actions.ts) for the complete `Search | Finish` loop.
+Constructors must only initialize state: union validation may construct candidate instances. Put network requests and other effects in `call`, then invoke the validated action separately. See the [search-agent actions](../examples/search-agent/actions.ts) for the complete `Search | Finish` loop.
 
 ## Names, inheritance, and custom construction
 

package/docs/REACT_INTEGRATION.md

@@ -0,0 +1,35 @@
+# React integration findings
+
+The [React board example](../examples/react-board/README.md) exercises `langfx.js@0.1.0-alpha.2` as an npm consumer. It has a separate package manifest and lockfile, and imports no library source files. Its browser path uses real Gemini; automated checks inject deterministic models.
+
+## What worked
+
+| Capability | Evidence |
+| --- | --- |
+| Typed class fields and bound action dependencies | The consumer typechecks against published declarations using `t.Class` and `t.schemaFrom`. |
+| Browser bundling | The production React bundle builds with esbuild, without Node shims or core library changes. |
+| Explicit preview, approval, and undo | Hook and rendered-app tests validate the application-owned flow using parsed action instances. |
+| Strict Mode | Rendering starts no model calls; inference begins in event handlers. Cleanup aborts active work on unmount. |
+| Request races | A ref blocks duplicate starts; aborted results cannot become proposals; a later request can complete. |
+
+## Integration work the app still owns
+
+React state must be updated when non-React objects mutate. The example takes a new board snapshot after each operation and stores it in `useState`. It keeps controllers and pending proposal instances in refs, avoiding a window where two clicks could start work before a state update renders.
+
+Cancellation has two responsibilities: stop the runtime request and prevent late completions from updating the component. The hook aborts on unmount and checks the active controller's identity during cleanup. Each model query and approval creates and disposes its own session.
+
+Minifiers can change JavaScript class names, so model-facing classes declare `schemaName`. Typed fields alone do not define domain permissions: draft methods still validate IDs and titles, and the store checks revisions before publishing changes.
+
+The app must also supply model transport/authentication and its own approval/undo policy. The npm package does not export the board's domain classes. This standalone consumer keeps a copy of those small example modules rather than depending on a checkout of the library.
+
+## API decision
+
+Keep `useBoardAgent` in the example for now. It contains board-specific behavior, and this single integration does not justify a general React package. The example now covers structured streaming as well as approval. Multiple concurrent sessions and other application domains still need evaluation before defining a reusable public hook.
+
+This check does not establish support for SSR/hydration, React Native, persistent approvals, or arbitrary external effects. React tests use jsdom; browser/model validation should be recorded separately from these deterministic checks. The setup follows React's preference for built-in state when the application can own its render data; [external-store subscriptions](https://react.dev/reference/react/useSyncExternalStore) remain an option for hosts with an existing store.
+
+## Streaming and inspection
+
+The React example consumes structured `queryStream` events. Raw output is bounded and display-only; a complete validated result and successful draft preview are both required before approval appears. Cancellation and unmount close the stream, and tests ensure a provider failure after complete-looking text cannot produce a proposal.
+
+An inspector combines app-owned planning state with projected Session action traces. Planning tokens come from the stream terminal event, because alpha.2 does not trace streamed queries through Session. This separation exposes a possible future framework improvement without inventing trace or usage data. Unknown usage remains unknown, including for failed streams.

package/docs/RELEASING.md

@@ -1,7 +1,30 @@
+# Session streaming alpha: 0.1.0-alpha.3
+
+Release target: `langfx.js@0.1.0-alpha.3` under the `alpha` dist-tag. Keep `latest` unchanged. Publication is pending registry verification.
+
+## Changes
+
+- `Session.queryStream` supports text and structured queries with inherited models, per-call overrides/deadlines, invocation ancestry, terminal results and reported usage.
+- Started streams close on session disposal, parent action completion, cancellation, deadline or early consumer return, including while the consumer is paused.
+- Traces finish after provider cleanup and before terminal delivery. Partial values remain display-only; missing usage remains unknown.
+- Repository CI now runs the full quality gate on Node 22 and 24 and checks a standalone React consumer of the published package.
+
+## Release validation
+
+The implementation passed 240 tests and the full type/browser/parity/packed-package checks, plus an independent read-only review with no findings. One live Gemini 3.7 Flash structured stream verified the typed answer, completed query trace, and provider-reported usage. Release archive checks must also pass for the versioned source.
+
+Use the publication procedure below with `0.1.0-alpha.3` substituted for older version examples. Verify the exact archive integrity against npm after publishing. This release does not add caching for streams, React bindings, or stronger guarantees for noncooperative providers.
+
+---
+
 # Typed classes alpha: 0.1.0-alpha.2
 
 Release target: `langfx.js@0.1.0-alpha.2` under the `alpha` dist-tag. The existing `latest` tag remains on `0.1.0-alpha.0`. Registry verification is required before declaring publication complete.
 
+## Publication status
+
+Published and registry-verified on 2026-09-26. `alpha` points to `0.1.0-alpha.2`; `latest` remains `0.1.0-alpha.0`. Registry SHA-512 integrity matches the reviewed archive, and a clean install of the exact published version passed the nested-class query smoke test. Tag `v0.1.0-alpha.2` identifies release source commit `7dc0206`.
+
 ## Included
 
 Async TypeScript APIs for messages, templates, language functions, typed queries, structured streaming, tools, agents, and invocation traces. Python constructor syntax is the default structured-query protocol; JSON is explicit. Gemini, Anthropic, and OpenAI adapters support fixture-tested image inputs and local tool continuations. The package is ESM with TypeScript declarations, targets Node.js 22+ and browser/worker hosts, and has no required runtime dependencies. Zod is an optional peer. MCP support includes `langfx.js/mcp` for remote Streamable HTTP and `langfx.js/mcp/node` for local stdio servers, using an optional `@modelcontextprotocol/client` 2.x peer. It includes input/output validation, explicit agent tool selection, cancellation and subprocess cleanup. Unexpected MCP disconnects retain their failure diagnostics.

package/docs/STREAMING.md

@@ -45,7 +45,31 @@ Strict JSON is required: no Markdown fences, comments, trailing commas, duplicat
 
 Consume the stream through a terminal event to determine the outcome. A completed iteration delivers exactly one terminal outcome. Setup errors may throw before iteration starts. Early `break` or iterator `return()` closes the provider without delivering a terminal event. Parser errors and terminal outcomes close the provider before the terminal event is yielded. Pass `signal` to cancel pending I/O; custom providers must implement cooperative cancellation and cleanup. No retries or output repair occur.
 
-Session-level streaming traces, streamed tool arguments, live-provider validation, and framework-specific UI bindings remain future work. Gemini integration is covered using mocked SSE responses.
+Session-level streaming traces are available through `Session.queryStream` in the source version described below. Gemini integration is covered using mocked SSE responses; live-provider coverage is documented separately.
+
+## Session-owned streams
+
+`Session.queryStream` accepts the same text or structured forms as `queryStream`, inherits the session's model, and accepts per-call model/signal overrides and `maxExecutionTime` in seconds. It returns an async iterable directly:
+
+```ts
+const session = new lf.Session({ lm });
+try {
+  for await (const event of session.queryStream('What is 6 × 7?', Answer, { maxExecutionTime: 30 })) {
+    if (event.type === 'generationComplete') console.log(event.result);
+  }
+  console.log(session.allQueries, session.usageSummary);
+} finally {
+  await session.dispose();
+}
+```
+
+Here `Answer` is your structured class/schema and `lm` is your model. A query trace starts on the first pull, under the calling session or action. Partial events do not set its result. The validated result (or final text), reported terminal usage, status, and end time are recorded after provider cleanup and before the final event/chunk reaches the consumer. Usage absent from the terminal output remains unknown; failed streams may incur usage that was not reported. No stream cache hits are inferred.
+
+Structured validation/provider failures and cancellation retain the ordinary terminal-event contract and mark the trace accordingly. Text failures throw. Session guards such as using a closed session or exceeding the trace limit reject iteration before creating a trace. Streams are single-use; concurrent `next()` calls are serialized.
+
+Breaking or returning early cancels the query trace and closes the provider. Disposing the session, ending its owning action, or reaching a deadline also closes a started stream even while its consumer is paused. If the consumer resumes after cancellation, structured streams expose a cancelled terminal event and text streams throw. An explicit iterator return discards that event. Never-started iterables allocate no query trace. Providers must cooperate with cancellation and implement iterator cleanup; the session waits for that cleanup, so a provider that never settles cannot be made safe by abandoning its work.
+
+Availability: `Session.queryStream` is included starting with `0.1.0-alpha.3`. Consumers pinned to alpha.2 must upgrade to use it.
 
 ## Python protocol
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langfx.js",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Language as functions for TypeScript applications",
   "type": "module",
   "license": "Apache-2.0",
@@ -70,7 +70,9 @@
     "prepack": "npm run build",
     "prepublishOnly": "npm run check",
     "serve:mcp-browser": "node scripts/serve-mcp-browser.mjs",
-    "example:app": "node examples/app/serve.mjs"
+    "example:search": "node examples/search-agent/serve.mjs",
+    "example:board": "node examples/board-agent/serve.mjs",
+    "example:approval": "node scripts/run-approval-example.mjs"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "2.0.0",