@jini-ai/daemon 0.3.0 → 0.3.2

package/dist/artifacts/runtime-compat.d.ts

@@ -1,37 +0,0 @@
-/**
- * @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.
- */
-/**
- * Rewrites an artifact body before it is served, keyed by the artifact's
- * file name (a host typically gates on file extension, as OD's origin did
- * with `.html`/`.htm`). Returns the body unchanged when no rewrite applies.
- */
-export type RuntimeCompatNormalizer = (name: string, body: unknown) => unknown;
-/** Applies no rewrite — returns `body` unchanged. Safe default until a host supplies its own normalizer(s). */
-export declare const noopRuntimeCompatNormalizer: RuntimeCompatNormalizer;
-/**
- * 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 declare function composeRuntimeCompatNormalizers(normalizers: readonly RuntimeCompatNormalizer[]): RuntimeCompatNormalizer;
-//# sourceMappingURL=runtime-compat.d.ts.map

package/dist/artifacts/runtime-compat.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-compat.d.ts","sourceRoot":"","sources":["../../src/artifacts/runtime-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;AAE/E,+GAA+G;AAC/G,eAAO,MAAM,2BAA2B,EAAE,uBAA+C,CAAC;AAE1F;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,SAAS,uBAAuB,EAAE,GAC9C,uBAAuB,CAEzB"}

package/dist/artifacts/runtime-compat.js

@@ -1,33 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,85 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,92 +0,0 @@
-/**
- * @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

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

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

@@ -1,73 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,198 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,68 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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"}