@jini-ai/daemon 0.1.0

package/dist/artifacts/runtime-compat.js

@@ -0,0 +1,33 @@
+/**
+ * @module artifacts/runtime-compat
+ *
+ * The runtime-compat injection seam: a hook that gets a chance to rewrite an
+ * artifact's body before it's served, for CDN/library-loading quirks a host
+ * knows about but the engine can't. Ported from OD's
+ * `apps/daemon/src/artifacts/runtime-compat.ts`.
+ *
+ * De-branded: the origin, `normalizeArtifactRuntimeImports`, is entirely a
+ * fix for one specific third-party CDN-bundle bug (the vanilla `dist/
+ * motion.js` UMD script tag lacking React hooks, rewritten to `dist/
+ * framer-motion.js`) that OD's own system prompt steers models toward
+ * hitting. That rewrite rule is product/library-specific knowledge, not a
+ * generic engine mechanism — per the task brief ("keep OD's specific logic
+ * as adapter"), it is not ported. What *is* generic and kept is the
+ * seam itself: a host may need to rewrite an artifact body for any number
+ * of environment-specific reasons (a different CDN quirk, a different
+ * runtime library entirely) before it reaches a renderer, so the engine
+ * defines the hook type and a safe default (identity) rather than hardcode
+ * any one library's fix.
+ */
+/** Applies no rewrite — returns `body` unchanged. Safe default until a host supplies its own normalizer(s). */
+export const noopRuntimeCompatNormalizer = (_name, body) => body;
+/**
+ * Composes several normalizers into one, applying each in order — the
+ * output of one becomes the input to the next. Lets a host layer multiple
+ * independent CDN/library fixes without each needing to know about the
+ * others.
+ */
+export function composeRuntimeCompatNormalizers(normalizers) {
+    return (name, body) => normalizers.reduce((current, normalize) => normalize(name, current), body);
+}
+//# sourceMappingURL=runtime-compat.js.map

package/dist/artifacts/runtime-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-compat.js","sourceRoot":"","sources":["../../src/artifacts/runtime-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,+GAA+G;AAC/G,MAAM,CAAC,MAAM,2BAA2B,GAA4B,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,WAA+C;IAE/C,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AACpG,CAAC"}

package/dist/artifacts/store.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @module artifacts/store
+ *
+ * `ArtifactStore` — the generic artifact-store kernel port. Ported from OD's
+ * `apps/daemon/src/artifacts/create.ts` create/manifest-resolution flow;
+ * "artifacts feel like a kernel-adjacent concept tied to runs producing
+ * output" per this task's brief — homed in `@jini/daemon` alongside
+ * `EventLog` (same async-port + in-memory-reference-implementation shape as
+ * `event-log.ts`), not `@jini/core` (which owns pure registries/DI, not
+ * stateful storage).
+ *
+ * De-branded: the origin's `createProjectArtifactFile` took OD's own
+ * product-shaped workspace/file-tree writer (a function keyed on OD's own
+ * workspace-root and workspace-id nouns) as its injected dependency, and a
+ * companion `postCreateArtifactRequest` built a request body for OD's own
+ * per-workspace HTTP file-upload route. Neither is a generic engine concern
+ * (a workspace model and an HTTP route shape are product surfaces), so this
+ * port defines `ArtifactStore.create/get/list` directly against an
+ * in-memory reference map — the origin's writer/request-builder pair were
+ * the composition points a real OD adapter would wire against this port
+ * from, not something to port verbatim. OD's HTML-prototype file-kind
+ * inference (`inferLegacyManifest`) stays adapter-owned — see
+ * `manifest.ts`'s `ManifestInferrer` seam.
+ */
+import { type ArtifactManifest, type ArtifactManifestTaxonomy, type ManifestInferrer } from './manifest.js';
+export declare class ArtifactManifestRequiredError extends Error {
+    readonly code: "ARTIFACT_MANIFEST_REQUIRED";
+    constructor(name: string);
+}
+export declare class ArtifactManifestInvalidError extends Error {
+    readonly code: "ARTIFACT_MANIFEST_INVALID";
+    constructor(message: string);
+}
+export interface CreateArtifactInput {
+    readonly name: string;
+    readonly content: string;
+    readonly encoding?: 'utf8' | 'base64';
+    /** Explicit manifest fields, or `undefined` to fall back to the store's {@link ManifestInferrer}. */
+    readonly artifactManifest?: unknown;
+}
+export interface ArtifactRecord {
+    readonly name: string;
+    readonly content: Buffer;
+    readonly manifest: ArtifactManifest;
+}
+/**
+ * A replayable, ordered artifact-manifest resolver: given a create request,
+ * either the caller-supplied manifest (validated against `taxonomy`) or the
+ * result of `inferManifest(name)` (also validated) becomes the record's
+ * manifest. Throws {@link ArtifactManifestRequiredError} when neither
+ * source produces one, {@link ArtifactManifestInvalidError} when the
+ * resolved manifest fails validation.
+ */
+export declare function resolveArtifactManifest(input: CreateArtifactInput, taxonomy: ArtifactManifestTaxonomy, inferManifest: ManifestInferrer): ArtifactManifest;
+/**
+ * A store of named artifacts with validated manifests. Kernel port —
+ * `@jini/daemon` ships `createInMemoryArtifactStore` as the reference
+ * implementation; a durable adapter (`@jini/sqlite`) can implement the same
+ * interface against real persistence.
+ */
+export interface ArtifactStore {
+    /**
+     * Creates or overwrites the artifact named `input.name`, resolving its
+     * manifest per {@link resolveArtifactManifest}.
+     * @throws {ArtifactManifestRequiredError} No manifest supplied and the inferrer produced none.
+     * @throws {ArtifactManifestInvalidError} The resolved manifest failed taxonomy validation.
+     */
+    create(input: CreateArtifactInput): Promise<ArtifactRecord>;
+    /** Returns the named artifact, or `null` if it doesn't exist. */
+    get(name: string): Promise<ArtifactRecord | null>;
+    /** Returns every stored artifact, most-recently-updated first. */
+    list(): Promise<ArtifactRecord[]>;
+}
+export interface InMemoryArtifactStoreOptions {
+    readonly taxonomy?: ArtifactManifestTaxonomy;
+    readonly inferManifest?: ManifestInferrer;
+}
+/**
+ * Reference `ArtifactStore` implementation: an in-memory `Map` keyed by
+ * artifact name. No durable persistence — matching this task's scope (a
+ * real persistent adapter is a future storage task's concern, mirroring
+ * `event-log.ts`'s own in-memory-only reference implementation).
+ */
+export declare function createInMemoryArtifactStore(options?: InMemoryArtifactStoreOptions): ArtifactStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/artifacts/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/artifacts/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAEvB,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,IAAI,EAAG,4BAA4B,CAAU;gBAE1C,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,EAAG,2BAA2B,CAAU;gBAEzC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACtC,qGAAqG;IACrG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,wBAAwB,EAClC,aAAa,EAAE,gBAAgB,GAC9B,gBAAgB,CAelB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5D,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClD,kEAAkE;IAClE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,aAAa,CA0BrG"}

package/dist/artifacts/store.js

@@ -0,0 +1,92 @@
+/**
+ * @module artifacts/store
+ *
+ * `ArtifactStore` — the generic artifact-store kernel port. Ported from OD's
+ * `apps/daemon/src/artifacts/create.ts` create/manifest-resolution flow;
+ * "artifacts feel like a kernel-adjacent concept tied to runs producing
+ * output" per this task's brief — homed in `@jini/daemon` alongside
+ * `EventLog` (same async-port + in-memory-reference-implementation shape as
+ * `event-log.ts`), not `@jini/core` (which owns pure registries/DI, not
+ * stateful storage).
+ *
+ * De-branded: the origin's `createProjectArtifactFile` took OD's own
+ * product-shaped workspace/file-tree writer (a function keyed on OD's own
+ * workspace-root and workspace-id nouns) as its injected dependency, and a
+ * companion `postCreateArtifactRequest` built a request body for OD's own
+ * per-workspace HTTP file-upload route. Neither is a generic engine concern
+ * (a workspace model and an HTTP route shape are product surfaces), so this
+ * port defines `ArtifactStore.create/get/list` directly against an
+ * in-memory reference map — the origin's writer/request-builder pair were
+ * the composition points a real OD adapter would wire against this port
+ * from, not something to port verbatim. OD's HTML-prototype file-kind
+ * inference (`inferLegacyManifest`) stays adapter-owned — see
+ * `manifest.ts`'s `ManifestInferrer` seam.
+ */
+import { emptyArtifactManifestTaxonomy, noopManifestInferrer, validateArtifactManifestInput, } from './manifest.js';
+export class ArtifactManifestRequiredError extends Error {
+    code = 'ARTIFACT_MANIFEST_REQUIRED';
+    constructor(name) {
+        super(`artifactManifest is required for ${name}; no safe default manifest can be inferred`);
+        this.name = 'ArtifactManifestRequiredError';
+    }
+}
+export class ArtifactManifestInvalidError extends Error {
+    code = 'ARTIFACT_MANIFEST_INVALID';
+    constructor(message) {
+        super(`invalid artifactManifest: ${message}`);
+        this.name = 'ArtifactManifestInvalidError';
+    }
+}
+/**
+ * A replayable, ordered artifact-manifest resolver: given a create request,
+ * either the caller-supplied manifest (validated against `taxonomy`) or the
+ * result of `inferManifest(name)` (also validated) becomes the record's
+ * manifest. Throws {@link ArtifactManifestRequiredError} when neither
+ * source produces one, {@link ArtifactManifestInvalidError} when the
+ * resolved manifest fails validation.
+ */
+export function resolveArtifactManifest(input, taxonomy, inferManifest) {
+    const manifest = input.artifactManifest !== undefined && input.artifactManifest !== null
+        ? input.artifactManifest
+        : inferManifest(input.name);
+    if (manifest) {
+        const validated = validateArtifactManifestInput(manifest, input.name, taxonomy);
+        if (!validated.ok) {
+            throw new ArtifactManifestInvalidError(validated.error);
+        }
+        // `manifest != null` above and `validateArtifactManifestInput` only
+        // returns `{ ok: true, value: null }` when its own `manifest` param is
+        // `== null` — so `validated.value` is non-null here.
+        return validated.value;
+    }
+    throw new ArtifactManifestRequiredError(input.name);
+}
+/**
+ * Reference `ArtifactStore` implementation: an in-memory `Map` keyed by
+ * artifact name. No durable persistence — matching this task's scope (a
+ * real persistent adapter is a future storage task's concern, mirroring
+ * `event-log.ts`'s own in-memory-only reference implementation).
+ */
+export function createInMemoryArtifactStore(options = {}) {
+    const taxonomy = options.taxonomy ?? emptyArtifactManifestTaxonomy;
+    const inferManifest = options.inferManifest ?? noopManifestInferrer;
+    const records = new Map();
+    return {
+        async create(input) {
+            const manifest = resolveArtifactManifest(input, taxonomy, inferManifest);
+            const content = input.encoding === 'base64'
+                ? Buffer.from(input.content, 'base64')
+                : Buffer.from(input.content, 'utf8');
+            const record = { name: input.name, content, manifest };
+            records.set(input.name, record);
+            return record;
+        },
+        async get(name) {
+            return records.get(name) ?? null;
+        },
+        async list() {
+            return Array.from(records.values()).sort((a, b) => b.manifest.updatedAt.localeCompare(a.manifest.updatedAt));
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/artifacts/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/artifacts/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,6BAA6B,GAI9B,MAAM,eAAe,CAAC;AAEvB,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC7C,IAAI,GAAG,4BAAqC,CAAC;IAEtD,YAAY,IAAY;QACtB,KAAK,CAAC,oCAAoC,IAAI,4CAA4C,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,GAAG,2BAAoC,CAAC;IAErD,YAAY,OAAe;QACzB,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAgBD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAA0B,EAC1B,QAAkC,EAClC,aAA+B;IAE/B,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,KAAK,SAAS,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI;QACtF,CAAC,CAAC,KAAK,CAAC,gBAAgB;QACxB,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,6BAA6B,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,4BAA4B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC;QACD,oEAAoE;QACpE,uEAAuE;QACvE,qDAAqD;QACrD,OAAO,SAAS,CAAC,KAAM,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,6BAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AA2BD;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,UAAwC,EAAE;IACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,6BAA6B,CAAC;IACnE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,oBAAoB,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAA0B;YACrC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,KAAK,QAAQ;gBACzC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;gBACtC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,MAAM,MAAM,GAAmB,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,IAAY;YACpB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QACnC,CAAC;QAED,KAAK,CAAC,IAAI;YACR,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CACnE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/artifacts/stub-guard.d.ts

@@ -0,0 +1,73 @@
+export type ArtifactStubGuardMode = 'reject' | 'warn' | 'off';
+export interface ArtifactStubGuardConfig {
+    readonly mode: ArtifactStubGuardMode;
+    readonly minRetainedRatio: number;
+    readonly minPriorBytes: number;
+    /** File-name extensions (including the leading dot) this guard scans for prior siblings, e.g. `['.html', '.htm']`. */
+    readonly siblingExtensions: readonly string[];
+}
+export interface PriorArtifactSibling {
+    readonly name: string;
+    readonly size: number;
+}
+export interface ArtifactStubGuardWarning {
+    readonly code: 'ARTIFACT_REGRESSION';
+    readonly message: string;
+    readonly identifier: string;
+    readonly newSize: number;
+    readonly priorSize: number;
+    readonly priorName: string;
+}
+export interface EvaluateArtifactStubGuardInput {
+    readonly scanDir: string;
+    readonly identifier: string;
+    readonly newSize: number;
+    readonly config: ArtifactStubGuardConfig;
+}
+export interface EvaluateArtifactStubGuardResult {
+    readonly outcome: 'pass' | 'warn' | 'reject';
+    readonly warning?: ArtifactStubGuardWarning;
+}
+export declare class ArtifactRegressionError extends Error {
+    readonly code = "ARTIFACT_REGRESSION";
+    readonly identifier: string;
+    readonly newSize: number;
+    readonly priorSize: number;
+    readonly priorName: string;
+    constructor(message: string, details: {
+        identifier: string;
+        newSize: number;
+        priorSize: number;
+        priorName: string;
+    });
+}
+export declare const DEFAULT_ARTIFACT_STUB_GUARD_CONFIG: ArtifactStubGuardConfig;
+/** Slugifies a free-form identifier into a filename-safe basename (lowercase, `[a-z0-9_-]`, max 60 chars). */
+export declare function slugifyArtifactIdentifier(value: string): string;
+/** Fallback basename used when a slugified identifier is empty (e.g. an all-non-ASCII identifier strips to nothing). */
+export declare const EMPTY_SLUG_FALLBACK_NAME = "artifact";
+/**
+ * Two identifiers refer to the same artifact lineage when they're literally
+ * equal, or one is the canonical slug form of the other (and that slug is
+ * non-empty). Slug equality alone is not enough: a slugifier that truncates
+ * at a fixed length would otherwise falsely bridge two distinct identifiers
+ * that only diverge past that length — requiring one side to *be* the slug
+ * form of the other avoids that while still bridging e.g. "Landing Page" and
+ * "landing-page".
+ */
+export declare function artifactIdentifiersMatch(a: string, b: string): boolean;
+/**
+ * Finds prior siblings on disk that share an identifier with a newly-written
+ * artifact, matching `<identifier>(-N)?.<ext>` for any of `config.siblingExtensions`.
+ * The scan deliberately includes any file at the same path as the new write
+ * — when a write overwrites an existing file with the same name, the file
+ * currently on disk is the prior content (the overwrite happens after this
+ * scan runs).
+ */
+export declare function findPriorArtifactSiblings(scanDir: string, identifier: string, config: Pick<ArtifactStubGuardConfig, 'siblingExtensions'>): Promise<PriorArtifactSibling[]>;
+/** Reads guard config from `ARTIFACT_STUB_GUARD` / `ARTIFACT_STUB_GUARD_MIN_RATIO` / `ARTIFACT_STUB_GUARD_MIN_PRIOR_BYTES`, falling back to `defaults` for any unset/invalid value. */
+export declare function readArtifactStubGuardConfigFromEnv(env?: NodeJS.ProcessEnv, defaults?: ArtifactStubGuardConfig): ArtifactStubGuardConfig;
+/** Pure decision function: given the prior siblings on disk, decides whether the new body is a stub regression. Split from the disk scan so unit tests stay fast and can pre-fetch siblings. */
+export declare function classifyArtifactStubGuard(priors: readonly PriorArtifactSibling[], identifier: string, newSize: number, config: ArtifactStubGuardConfig): EvaluateArtifactStubGuardResult;
+export declare function evaluateArtifactStubGuard(input: EvaluateArtifactStubGuardInput): Promise<EvaluateArtifactStubGuardResult>;
+//# sourceMappingURL=stub-guard.d.ts.map

package/dist/artifacts/stub-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-guard.d.ts","sourceRoot":"","sources":["../../src/artifacts/stub-guard.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sHAAsH;IACtH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;CAC1C;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CASzF;AAED,eAAO,MAAM,kCAAkC,EAAE,uBAKhD,CAAC;AAMF,8GAA8G;AAC9G,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,wHAAwH;AACxH,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAOtE;AA0BD;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,GACzD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA2CjC;AAED,uLAAuL;AACvL,wBAAgB,kCAAkC,CAChD,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,uBAA4D,GACrE,uBAAuB,CAezB;AAiBD,gMAAgM;AAChM,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,oBAAoB,EAAE,EACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,uBAAuB,GAC9B,+BAA+B,CAqBjC;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,+BAA+B,CAAC,CAK1C"}

package/dist/artifacts/stub-guard.js

@@ -0,0 +1,198 @@
+import { readFile, readdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+export class ArtifactRegressionError extends Error {
+    code = 'ARTIFACT_REGRESSION';
+    identifier;
+    newSize;
+    priorSize;
+    priorName;
+    constructor(message, details) {
+        super(message);
+        this.name = 'ArtifactRegressionError';
+        this.identifier = details.identifier;
+        this.newSize = details.newSize;
+        this.priorSize = details.priorSize;
+        this.priorName = details.priorName;
+    }
+}
+export const DEFAULT_ARTIFACT_STUB_GUARD_CONFIG = {
+    mode: 'warn',
+    minRetainedRatio: 0.2,
+    minPriorBytes: 4096,
+    siblingExtensions: ['.html', '.htm'],
+};
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Slugifies a free-form identifier into a filename-safe basename (lowercase, `[a-z0-9_-]`, max 60 chars). */
+export function slugifyArtifactIdentifier(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60);
+}
+/** Fallback basename used when a slugified identifier is empty (e.g. an all-non-ASCII identifier strips to nothing). */
+export const EMPTY_SLUG_FALLBACK_NAME = 'artifact';
+/**
+ * Two identifiers refer to the same artifact lineage when they're literally
+ * equal, or one is the canonical slug form of the other (and that slug is
+ * non-empty). Slug equality alone is not enough: a slugifier that truncates
+ * at a fixed length would otherwise falsely bridge two distinct identifiers
+ * that only diverge past that length — requiring one side to *be* the slug
+ * form of the other avoids that while still bridging e.g. "Landing Page" and
+ * "landing-page".
+ */
+export function artifactIdentifiersMatch(a, b) {
+    if (a === b)
+        return true;
+    const slugA = slugifyArtifactIdentifier(a);
+    if (slugA.length === 0)
+        return false;
+    const slugB = slugifyArtifactIdentifier(b);
+    if (slugA !== slugB)
+        return false;
+    return a === slugA || b === slugB;
+}
+async function readSidecarIdentifier(scanDir, entryName) {
+    try {
+        const raw = await readFile(path.join(scanDir, `${entryName}.artifact.json`), 'utf8');
+        const parsed = JSON.parse(raw);
+        const id = parsed?.metadata?.identifier;
+        return typeof id === 'string' && id.length > 0 ? id : null;
+    }
+    catch {
+        return null;
+    }
+}
+function extensionAlternation(extensions) {
+    return extensions.map((ext) => escapeRegExp(ext)).join('|');
+}
+function legacyCandidateIdentifiers(filename, extensionPattern, suffixPattern) {
+    const fullBasename = filename.replace(extensionPattern, '');
+    const stripped = filename.replace(suffixPattern, '');
+    const candidates = [];
+    if (fullBasename.length > 0)
+        candidates.push(fullBasename);
+    if (stripped.length > 0 && stripped !== fullBasename)
+        candidates.push(stripped);
+    return candidates;
+}
+/**
+ * Finds prior siblings on disk that share an identifier with a newly-written
+ * artifact, matching `<identifier>(-N)?.<ext>` for any of `config.siblingExtensions`.
+ * The scan deliberately includes any file at the same path as the new write
+ * — when a write overwrites an existing file with the same name, the file
+ * currently on disk is the prior content (the overwrite happens after this
+ * scan runs).
+ */
+export async function findPriorArtifactSiblings(scanDir, identifier, config) {
+    if (identifier.length === 0)
+        return [];
+    const extAlternation = extensionAlternation(config.siblingExtensions);
+    if (!extAlternation)
+        return [];
+    const extensionPattern = new RegExp(`(?:${extAlternation})$`, 'i');
+    const suffixPattern = new RegExp(`(?:-\\d+)?(?:${extAlternation})$`, 'i');
+    const tokens = new Set();
+    tokens.add(identifier);
+    const slug = slugifyArtifactIdentifier(identifier);
+    if (slug.length > 0)
+        tokens.add(slug);
+    else
+        tokens.add(EMPTY_SLUG_FALLBACK_NAME);
+    const alternation = Array.from(tokens, escapeRegExp).join('|');
+    const pattern = new RegExp(`^(?:${alternation})(?:-\\d+)?(?:${extAlternation})$`, 'i');
+    let entries;
+    try {
+        entries = await readdir(scanDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        if (!pattern.test(entry.name))
+            continue;
+        const sidecarIdentifier = await readSidecarIdentifier(scanDir, entry.name);
+        // `legacyCandidateIdentifiers` always returns at least one non-empty
+        // candidate here: `entry.name` already matched `pattern` above, which
+        // requires its basename to start with one of `tokens` (all non-empty),
+        // so an explicit `candidateIdentifiers.length === 0` guard would be
+        // dead code — an empty array's `.some()` below already `continue`s.
+        const candidateIdentifiers = sidecarIdentifier !== null
+            ? [sidecarIdentifier]
+            : legacyCandidateIdentifiers(entry.name, extensionPattern, suffixPattern);
+        if (!candidateIdentifiers.some((c) => artifactIdentifiersMatch(identifier, c)))
+            continue;
+        try {
+            const st = await stat(path.join(scanDir, entry.name));
+            results.push({ name: entry.name, size: st.size });
+        }
+        catch {
+            // Ignore unreadable entries — they don't influence the guard decision.
+        }
+    }
+    return results;
+}
+/** Reads guard config from `ARTIFACT_STUB_GUARD` / `ARTIFACT_STUB_GUARD_MIN_RATIO` / `ARTIFACT_STUB_GUARD_MIN_PRIOR_BYTES`, falling back to `defaults` for any unset/invalid value. */
+export function readArtifactStubGuardConfigFromEnv(env = process.env, defaults = DEFAULT_ARTIFACT_STUB_GUARD_CONFIG) {
+    const rawMode = (env.ARTIFACT_STUB_GUARD ?? '').toLowerCase();
+    const mode = rawMode === 'reject' || rawMode === 'warn' || rawMode === 'off' ? rawMode : defaults.mode;
+    const ratioRaw = Number(env.ARTIFACT_STUB_GUARD_MIN_RATIO);
+    // Accept (0, 1] so a caller can set 1 to reject any shrinkage. Values <=0 or >1 fall back to default.
+    const minRetainedRatio = Number.isFinite(ratioRaw) && ratioRaw > 0 && ratioRaw <= 1 ? ratioRaw : defaults.minRetainedRatio;
+    const minPriorBytesRaw = Number(env.ARTIFACT_STUB_GUARD_MIN_PRIOR_BYTES);
+    const minPriorBytes = Number.isInteger(minPriorBytesRaw) && minPriorBytesRaw > 0 ? minPriorBytesRaw : defaults.minPriorBytes;
+    return { mode, minRetainedRatio, minPriorBytes, siblingExtensions: defaults.siblingExtensions };
+}
+function buildWarning(identifier, newSize, prior) {
+    return {
+        code: 'ARTIFACT_REGRESSION',
+        message: `New artifact body for identifier "${identifier}" is ${newSize} bytes, ` +
+            `but the largest prior sibling "${prior.name}" is ${prior.size} bytes. ` +
+            'This pattern usually means the write emitted a placeholder instead of the full document. ' +
+            'Set the guard mode to "warn" to record the warning without rejecting, or "off" to disable the guard entirely.',
+        identifier,
+        newSize,
+        priorSize: prior.size,
+        priorName: prior.name,
+    };
+}
+/** Pure decision function: given the prior siblings on disk, decides whether the new body is a stub regression. Split from the disk scan so unit tests stay fast and can pre-fetch siblings. */
+export function classifyArtifactStubGuard(priors, identifier, newSize, config) {
+    if (config.mode === 'off')
+        return { outcome: 'pass' };
+    if (identifier.length === 0)
+        return { outcome: 'pass' };
+    if (priors.length === 0)
+        return { outcome: 'pass' };
+    let largestSoFar = null;
+    for (const prior of priors) {
+        if (largestSoFar === null || prior.size > largestSoFar.size)
+            largestSoFar = prior;
+    }
+    // Non-null assertion, not a runtime guard: `priors.length === 0` already
+    // returned above, so this loop always runs at least once, and its first
+    // iteration always satisfies `largestSoFar === null` — it's always
+    // assigned by the time the loop finishes.
+    const largest = largestSoFar;
+    if (largest.size < config.minPriorBytes)
+        return { outcome: 'pass' };
+    const threshold = largest.size * config.minRetainedRatio;
+    if (newSize >= threshold)
+        return { outcome: 'pass' };
+    const warning = buildWarning(identifier, newSize, largest);
+    return { outcome: config.mode === 'reject' ? 'reject' : 'warn', warning };
+}
+export async function evaluateArtifactStubGuard(input) {
+    if (input.config.mode === 'off')
+        return { outcome: 'pass' };
+    if (input.identifier.length === 0)
+        return { outcome: 'pass' };
+    const priors = await findPriorArtifactSiblings(input.scanDir, input.identifier, input.config);
+    return classifyArtifactStubGuard(priors, input.identifier, input.newSize, input.config);
+}
+//# sourceMappingURL=stub-guard.js.map

package/dist/artifacts/stub-guard.js.map

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

package/dist/artifacts/text-suppression.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @module artifacts/text-suppression
+ *
+ * A streaming-text state machine that suppresses a tagged block (matched by
+ * caller-supplied open/close patterns) from user-visible output while it's
+ * still arriving — used to hide an artifact's raw markup from chat prose
+ * while it streams in, without buffering the whole response first. Ported
+ * from OD's `apps/daemon/src/artifacts/text-suppression.ts`.
+ *
+ * The core (`createTaggedTextSuppressor`) was already fully generic in the
+ * origin — it takes its open/close regexes and open/close prefix-match
+ * predicates as parameters, no product coupling. What needed de-branding
+ * were the origin's two pre-built instances: `createDsmlArtifactTextSuppressor`
+ * hardcoded OD's own "DSML" markup-language tag name family
+ * (`<|DSML artifact>`/`<artifact>`) as its open/close patterns.
+ * `createXmlTagTextSuppressor` below replaces it — a generic factory taking
+ * the caller's own tag-name list instead of a hardcoded vocabulary. The
+ * `tool_call`/`edit` pairing the origin's other instance
+ * (`createToolCallTextSuppressor`) suppressed is a generic agent-protocol
+ * convention, not OD-branded, and is kept as a named default instance.
+ */
+export type StreamTextEvent = {
+    readonly type: 'text_delta';
+    readonly delta: string;
+};
+export type StreamEventSink = (event: StreamTextEvent) => void;
+export interface ArtifactTextSuppressor {
+    strip(text: string): string;
+    flush(): string;
+    isSuppressing(): boolean;
+    hasPendingCandidate(): boolean;
+    stats(): ArtifactTextSuppressorStats;
+}
+export interface ArtifactTextSuppressorStats {
+    readonly suppressedChars: number;
+    readonly suppressedChunks: number;
+    readonly openedBlocks: number;
+    readonly closedBlocks: number;
+    readonly pendingCandidateChars: number;
+    readonly suppressing: boolean;
+}
+/**
+ * Builds a suppressor for a tagged block delimited by `openRe`/`closeRe`.
+ * `isPossibleOpen`/`isPossibleClose` decide whether a trailing `<...`
+ * fragment (with no closing `>` yet) *could* still become a match once more
+ * text arrives — this is what lets the suppressor hold back a
+ * not-yet-decidable tail across streaming chunk boundaries instead of
+ * either emitting a tag fragment early or hanging indefinitely on a `<` that
+ * turns out to be unrelated text.
+ */
+export declare function createTaggedTextSuppressor(args: {
+    openRe: RegExp;
+    closeRe: RegExp;
+    isPossibleOpen: (text: string) => boolean;
+    isPossibleClose: (text: string) => boolean;
+}): ArtifactTextSuppressor;
+/** Feeds `text` through `suppressor` and emits a `text_delta` on `onEvent` only when something survives. Returns whether an event was emitted. */
+export declare function emitWithTextSuppressor(suppressor: ArtifactTextSuppressor, onEvent: StreamEventSink, text: string): boolean;
+/**
+ * Builds a suppressor for an XML-like `<tagName ...>...</tagName>` block (or
+ * a bracket-pipe variant `<|tagName ...>...<|/tagName|>`), matched
+ * case-insensitively against any of `tagNames`. Replaces the origin's
+ * hardcoded "DSML" tag-name family with a caller-supplied vocabulary.
+ */
+export declare function createXmlTagTextSuppressor(tagNames: readonly string[]): ArtifactTextSuppressor;
+/** Suppresses a `<tool_call>...</tool_call>` or `<edit>...</edit>` block — a generic agent-protocol convention, not product-branded. */
+export declare function createToolCallTextSuppressor(): ArtifactTextSuppressor;
+//# sourceMappingURL=text-suppression.d.ts.map

package/dist/artifacts/text-suppression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-suppression.d.ts","sourceRoot":"","sources":["../../src/artifacts/text-suppression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACtF,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,KAAK,IAAI,MAAM,CAAC;IAChB,aAAa,IAAI,OAAO,CAAC;IACzB,mBAAmB,IAAI,OAAO,CAAC;IAC/B,KAAK,IAAI,2BAA2B,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAID;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,GAAG,sBAAsB,CAgFzB;AAED,kJAAkJ;AAClJ,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,GACX,OAAO,CAKT;AAqBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,sBAAsB,CAmB9F;AAoBD,wIAAwI;AACxI,wBAAgB,4BAA4B,IAAI,sBAAsB,CAOrE"}