@framers/agentos 0.9.33 → 0.9.35

package/dist/index.js

@@ -97,6 +97,10 @@ export * from './cognition/rag/index.js';
 export { DEFAULT_MEMORY_RETRIEVAL_POLICY, buildRetrievalPlanFromPolicy, getCandidateLimit, resolveMemoryRetrievalPolicy, } from './cognition/rag/unified/policy.js';
 // Cognitive Memory System
 export * from './cognition/memory/index.js';
+// Memory Wiki — markdown-first long-term memory for soul-file agents
+export { WikiMemoryStore, WikiCompiler, ensureMemoryDir, parsePage, serializePage, renderCatalog, extractWikiLinks, WIKI_PAGE_TYPES, isWikiPageType, } from './cognition/substrate/memory/wiki/index.js';
+export { attachMemoryWiki } from './cognition/memory/io/attachMemoryWiki.js';
+export { ReadMemoryPageTool } from './cognition/memory/io/tools/ReadMemoryPageTool.js';
 // Query Router (classification, retrieval dispatch, grounded answer generation)
 export { QueryClassifier, QueryDispatcher, QueryGenerator, QueryRouter, TopicExtractor, KeywordFallback, } from './orchestration/pipeline/query/index.js';
 // Orchestration Layer (IR, Events, Checkpoint, Runtime)
@@ -114,6 +118,7 @@ export { generateText, isRetryableError, isContentPolicyRefusal, buildFallbackCh
 export { normalizeHostLLMPolicy } from './api/runtime/hostPolicy.js';
 export { streamText } from './api/streamText.js';
 export { agent } from './api/agent.js';
+export { souledAgent } from './api/souledAgent.js';
 export { ModelRouter } from './core/llm/routing/ModelRouter.js';
 export { agency, runPostApprovalGuardrails } from './api/agency.js';
 export { exportAgentConfig, exportAgentConfigJSON, exportAgentConfigYAML, importAgent, importAgentFromJSON, importAgentFromYAML, validateAgentExport, } from './api/agentExport.js';
@@ -127,6 +132,8 @@ export { generateImage } from './api/generateImage.js';
 export { editImage } from './api/editImage.js';
 export { upscaleImage } from './api/upscaleImage.js';
 export { variateImage } from './api/variateImage.js';
+export { segment } from './api/segment.js';
+export { maskToEditMask, cropRegion, ReplicateSegmentationProvider, registerSegmentationProvider, resolveSegmentationProvider, resetSegmentationProviders, SegmentationModeNotSupportedError, InvalidSegmentationPromptError, SegmentationProviderError, } from './io/segmentation/index.js';
 export { generateVideo } from './api/generateVideo.js';
 export { generateMusic } from './api/generateMusic.js';
 export { generateSFX } from './api/generateSFX.js';

package/dist/index.js.map

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

package/dist/io/segmentation/SegmentationProviderRegistry.d.ts

@@ -0,0 +1,12 @@
+import type { ISegmentationProvider, SegmentationProviderId } from './types.js';
+/** Register (or override) a provider instance. */
+export declare function registerSegmentationProvider(id: string, provider: ISegmentationProvider): void;
+/** Clear all cached/registered instances. */
+export declare function resetSegmentationProviders(): void;
+/**
+ * Resolve a provider, lazily constructing built-ins from env on first use.
+ *
+ * @throws when the provider id is unknown or required configuration is missing.
+ */
+export declare function resolveSegmentationProvider(id?: SegmentationProviderId): Promise<ISegmentationProvider>;
+//# sourceMappingURL=SegmentationProviderRegistry.d.ts.map

package/dist/io/segmentation/SegmentationProviderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentationProviderRegistry.d.ts","sourceRoot":"","sources":["../../../src/io/segmentation/SegmentationProviderRegistry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIhF,kDAAkD;AAClD,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAE9F;AAED,6CAA6C;AAC7C,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,EAAE,GAAE,sBAAoC,GACvC,OAAO,CAAC,qBAAqB,CAAC,CAgBhC"}

package/dist/io/segmentation/SegmentationProviderRegistry.js

@@ -0,0 +1,39 @@
+/**
+ * @module io/segmentation/SegmentationProviderRegistry
+ *
+ * Resolves segmentation providers by id, lazily constructing built-ins from
+ * environment configuration on first use. Custom providers and tests can
+ * inject instances via {@link registerSegmentationProvider}.
+ */
+import { ReplicateSegmentationProvider } from './providers/ReplicateSegmentationProvider.js';
+const instances = new Map();
+/** Register (or override) a provider instance. */
+export function registerSegmentationProvider(id, provider) {
+    instances.set(id, provider);
+}
+/** Clear all cached/registered instances. */
+export function resetSegmentationProviders() {
+    instances.clear();
+}
+/**
+ * Resolve a provider, lazily constructing built-ins from env on first use.
+ *
+ * @throws when the provider id is unknown or required configuration is missing.
+ */
+export async function resolveSegmentationProvider(id = 'replicate') {
+    const existing = instances.get(id);
+    if (existing)
+        return existing;
+    if (id === 'replicate') {
+        const apiKey = process.env.REPLICATE_API_TOKEN?.trim();
+        if (!apiKey) {
+            throw new Error('Segmentation provider "replicate" requires REPLICATE_API_TOKEN.');
+        }
+        const provider = new ReplicateSegmentationProvider();
+        await provider.initialize({ apiKey });
+        instances.set(id, provider);
+        return provider;
+    }
+    throw new Error(`Unknown segmentation provider "${id}".`);
+}
+//# sourceMappingURL=SegmentationProviderRegistry.js.map

package/dist/io/segmentation/SegmentationProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentationProviderRegistry.js","sourceRoot":"","sources":["../../../src/io/segmentation/SegmentationProviderRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAG7F,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;AAE3D,kDAAkD;AAClD,MAAM,UAAU,4BAA4B,CAAC,EAAU,EAAE,QAA+B;IACtF,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,0BAA0B;IACxC,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,KAA6B,WAAW;IAExC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,6BAA6B,EAAE,CAAC;QACrD,MAAM,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACtC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC"}

package/dist/io/segmentation/consumers/cropRegion.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module io/segmentation/consumers/cropRegion
+ */
+import type { SegmentMask } from '../types.js';
+/**
+ * Apply a mask as the alpha channel of the source image and crop to the mask's
+ * bbox, producing a transparent cutout (sprite primitive / CLIP-embed input).
+ *
+ * @param opts.pad pixels to expand the crop on each side (default 0)
+ * @param opts.background `'transparent'` (default) keeps alpha; `'opaque'` flattens to black
+ */
+export declare function cropRegion(source: Buffer | Uint8Array | string, mask: SegmentMask, opts?: {
+    pad?: number;
+    background?: 'transparent' | 'opaque';
+}): Promise<Buffer>;
+//# sourceMappingURL=cropRegion.d.ts.map

package/dist/io/segmentation/consumers/cropRegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cropRegion.d.ts","sourceRoot":"","sources":["../../../../src/io/segmentation/consumers/cropRegion.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,EACpC,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAA;CAAO,GACjE,OAAO,CAAC,MAAM,CAAC,CAqCjB"}

package/dist/io/segmentation/consumers/cropRegion.js

@@ -0,0 +1,41 @@
+/**
+ * Apply a mask as the alpha channel of the source image and crop to the mask's
+ * bbox, producing a transparent cutout (sprite primitive / CLIP-embed input).
+ *
+ * @param opts.pad pixels to expand the crop on each side (default 0)
+ * @param opts.background `'transparent'` (default) keeps alpha; `'opaque'` flattens to black
+ */
+export async function cropRegion(source, mask, opts = {}) {
+    const sharp = (await import('sharp')).default;
+    const srcBuf = typeof source === 'string' ? source : Buffer.isBuffer(source) ? source : Buffer.from(source);
+    const meta = await sharp(srcBuf).metadata();
+    const W = meta.width ?? 0;
+    const H = meta.height ?? 0;
+    const pad = opts.pad ?? 0;
+    // Mask luma -> single-channel alpha, resized to source dimensions.
+    const alpha = await sharp(mask.mask)
+        .resize(W, H, { fit: 'fill' })
+        .greyscale()
+        .toColourspace('b-w')
+        .raw()
+        .toBuffer();
+    // Source RGB (raw) + joined alpha channel -> RGBA.
+    const rgb = await sharp(srcBuf).removeAlpha().toColourspace('srgb').raw().toBuffer();
+    const rgba = await sharp(rgb, { raw: { width: W, height: H, channels: 3 } })
+        .joinChannel(alpha, { raw: { width: W, height: H, channels: 1 } })
+        .png()
+        .toBuffer();
+    // Clamp each edge independently so padding near an image boundary does not
+    // overshoot the opposite edge.
+    const left = Math.max(0, mask.bbox.x - pad);
+    const top = Math.max(0, mask.bbox.y - pad);
+    const right = Math.min(W, mask.bbox.x + mask.bbox.width + pad);
+    const bottom = Math.min(H, mask.bbox.y + mask.bbox.height + pad);
+    const w = right - left;
+    const h = bottom - top;
+    let out = sharp(rgba).extract({ left, top, width: w, height: h });
+    if (opts.background === 'opaque')
+        out = out.flatten({ background: { r: 0, g: 0, b: 0 } });
+    return out.png().toBuffer();
+}
+//# sourceMappingURL=cropRegion.js.map

package/dist/io/segmentation/consumers/cropRegion.js.map

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

package/dist/io/segmentation/consumers/maskToEditMask.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module io/segmentation/consumers/maskToEditMask
+ */
+import type { SegmentMask } from '../types.js';
+/**
+ * Combine one or more segmentation masks into a single mask Buffer suitable for
+ * `editImage()`'s `mask` input (white = edit region, black = keep).
+ *
+ * @param masks one mask or many (unioned)
+ * @param opts.target `'object'` (default) edits the masked object; `'background'`
+ *   inverts so everything except the object is edited.
+ * @param opts.width/height optional canvas size; defaults to the first mask's.
+ */
+export declare function maskToEditMask(masks: SegmentMask | SegmentMask[], opts?: {
+    target?: 'object' | 'background';
+    width?: number;
+    height?: number;
+}): Promise<Buffer>;
+//# sourceMappingURL=maskToEditMask.d.ts.map

package/dist/io/segmentation/consumers/maskToEditMask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskToEditMask.d.ts","sourceRoot":"","sources":["../../../../src/io/segmentation/consumers/maskToEditMask.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,EAClC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/E,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/io/segmentation/consumers/maskToEditMask.js

@@ -0,0 +1,32 @@
+/**
+ * Combine one or more segmentation masks into a single mask Buffer suitable for
+ * `editImage()`'s `mask` input (white = edit region, black = keep).
+ *
+ * @param masks one mask or many (unioned)
+ * @param opts.target `'object'` (default) edits the masked object; `'background'`
+ *   inverts so everything except the object is edited.
+ * @param opts.width/height optional canvas size; defaults to the first mask's.
+ */
+export async function maskToEditMask(masks, opts = {}) {
+    const sharp = (await import('sharp')).default;
+    const list = Array.isArray(masks) ? masks : [masks];
+    if (list.length === 0)
+        throw new Error('maskToEditMask requires at least one mask.');
+    const first = await sharp(list[0].mask).metadata();
+    const width = opts.width ?? first.width ?? 0;
+    const height = opts.height ?? first.height ?? 0;
+    if (width <= 0 || height <= 0) {
+        throw new Error('maskToEditMask: could not determine mask dimensions; pass opts.width and opts.height.');
+    }
+    const layers = await Promise.all(list.map(async (m) => ({
+        input: await sharp(m.mask).resize(width, height, { fit: 'fill' }).greyscale().png().toBuffer(),
+        blend: 'screen', // white-on-black union
+    })));
+    let composed = sharp({ create: { width, height, channels: 3, background: { r: 0, g: 0, b: 0 } } })
+        .composite(layers)
+        .greyscale();
+    if (opts.target === 'background')
+        composed = composed.negate();
+    return composed.png().toBuffer();
+}
+//# sourceMappingURL=maskToEditMask.js.map

package/dist/io/segmentation/consumers/maskToEditMask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskToEditMask.js","sourceRoot":"","sources":["../../../../src/io/segmentation/consumers/maskToEditMask.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAkC,EAClC,OAA8E,EAAE;IAEhF,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAErF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAChD,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAC9F,KAAK,EAAE,QAAiB,EAAE,uBAAuB;KAClD,CAAC,CAAC,CACJ,CAAC;IAEF,IAAI,QAAQ,GAAG,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;SAC/F,SAAS,CAAC,MAAM,CAAC;SACjB,SAAS,EAAE,CAAC;IAEf,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY;QAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC/D,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC"}

package/dist/io/segmentation/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module io/segmentation/errors
+ * Typed error classes for the segmentation surface. Callers can catch by class
+ * to branch on the failure cause.
+ */
+import type { SegmentationMode } from './types.js';
+/**
+ * Thrown before any network call when the resolved provider does not support
+ * the requested prompt mode.
+ */
+export declare class SegmentationModeNotSupportedError extends Error {
+    /** The provider that was asked to segment. */
+    readonly providerId: string;
+    /** The unsupported mode. */
+    readonly mode: SegmentationMode;
+    constructor(providerId: string, mode: SegmentationMode);
+}
+/** Thrown when zero or more than one prompt mode is supplied. */
+export declare class InvalidSegmentationPromptError extends Error {
+    constructor(message: string);
+}
+/** Discriminates the kind of provider-level failure. */
+export type SegmentationErrorCode = 'provider_failed' | 'timeout' | 'invalid_request';
+/** Wraps provider/network failures and poll timeouts. */
+export declare class SegmentationProviderError extends Error {
+    /** Failure category. */
+    readonly code: SegmentationErrorCode;
+    /** Underlying cause, when one exists. */
+    readonly cause?: unknown;
+    constructor(message: string, code: SegmentationErrorCode, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/io/segmentation/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/io/segmentation/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,qBAAa,iCAAkC,SAAQ,KAAK;IAC1D,8CAA8C;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,4BAA4B;IAC5B,SAAgB,IAAI,EAAE,gBAAgB,CAAC;gBAE3B,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB;CAMvD;AAED,iEAAiE;AACjE,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAEtF,yDAAyD;AACzD,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,wBAAwB;IACxB,SAAgB,IAAI,EAAE,qBAAqB,CAAC;IAC5C,yCAAyC;IACzC,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,OAAO;CAM1E"}

package/dist/io/segmentation/errors.js

@@ -0,0 +1,29 @@
+/**
+ * Thrown before any network call when the resolved provider does not support
+ * the requested prompt mode.
+ */
+export class SegmentationModeNotSupportedError extends Error {
+    constructor(providerId, mode) {
+        super(`Segmentation mode "${mode}" is not supported by provider "${providerId}".`);
+        this.name = 'SegmentationModeNotSupportedError';
+        this.providerId = providerId;
+        this.mode = mode;
+    }
+}
+/** Thrown when zero or more than one prompt mode is supplied. */
+export class InvalidSegmentationPromptError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidSegmentationPromptError';
+    }
+}
+/** Wraps provider/network failures and poll timeouts. */
+export class SegmentationProviderError extends Error {
+    constructor(message, code, cause) {
+        super(message);
+        this.name = 'SegmentationProviderError';
+        this.code = code;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/io/segmentation/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/io/segmentation/errors.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IAM1D,YAAY,UAAkB,EAAE,IAAsB;QACpD,KAAK,CAAC,sBAAsB,IAAI,mCAAmC,UAAU,IAAI,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAKD,yDAAyD;AACzD,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAMlD,YAAY,OAAe,EAAE,IAA2B,EAAE,KAAe;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/io/segmentation/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module io/segmentation
+ * Public barrel for the image segmentation surface.
+ */
+export * from './types.js';
+export * from './errors.js';
+export { resolveSegmentationMode } from './resolveMode.js';
+export { computeMaskBbox } from './maskGeometry.js';
+export { ReplicateSegmentationProvider } from './providers/ReplicateSegmentationProvider.js';
+export { resolveSegmentationProvider, registerSegmentationProvider, resetSegmentationProviders, } from './SegmentationProviderRegistry.js';
+export { maskToEditMask } from './consumers/maskToEditMask.js';
+export { cropRegion } from './consumers/cropRegion.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/io/segmentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/io/segmentation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/io/segmentation/index.js

@@ -0,0 +1,13 @@
+/**
+ * @module io/segmentation
+ * Public barrel for the image segmentation surface.
+ */
+export * from './types.js';
+export * from './errors.js';
+export { resolveSegmentationMode } from './resolveMode.js';
+export { computeMaskBbox } from './maskGeometry.js';
+export { ReplicateSegmentationProvider } from './providers/ReplicateSegmentationProvider.js';
+export { resolveSegmentationProvider, registerSegmentationProvider, resetSegmentationProviders, } from './SegmentationProviderRegistry.js';
+export { maskToEditMask } from './consumers/maskToEditMask.js';
+export { cropRegion } from './consumers/cropRegion.js';
+//# sourceMappingURL=index.js.map

package/dist/io/segmentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/io/segmentation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/io/segmentation/maskGeometry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module io/segmentation/maskGeometry
+ */
+import type { SegmentationBox } from './types.js';
+/**
+ * Compute the tight bounding box of the white (luma >= 128) pixels in a mask.
+ * Returns `null` when the mask has no white pixels.
+ *
+ * sharp is loaded lazily, matching the guarded dynamic-import pattern used by
+ * the vision pipeline (src/io/vision/VisionPipeline.ts).
+ */
+export declare function computeMaskBbox(maskPng: Buffer): Promise<SegmentationBox | null>;
+//# sourceMappingURL=maskGeometry.d.ts.map

package/dist/io/segmentation/maskGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskGeometry.d.ts","sourceRoot":"","sources":["../../../src/io/segmentation/maskGeometry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwBtF"}

package/dist/io/segmentation/maskGeometry.js

@@ -0,0 +1,37 @@
+/**
+ * Compute the tight bounding box of the white (luma >= 128) pixels in a mask.
+ * Returns `null` when the mask has no white pixels.
+ *
+ * sharp is loaded lazily, matching the guarded dynamic-import pattern used by
+ * the vision pipeline (src/io/vision/VisionPipeline.ts).
+ */
+export async function computeMaskBbox(maskPng) {
+    const sharp = (await import('sharp')).default;
+    const { data, info } = await sharp(maskPng)
+        .greyscale()
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    const { width, height, channels } = info;
+    let minX = width;
+    let minY = height;
+    let maxX = -1;
+    let maxY = -1;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            if (data[(y * width + x) * channels] >= 128) {
+                if (x < minX)
+                    minX = x;
+                if (y < minY)
+                    minY = y;
+                if (x > maxX)
+                    maxX = x;
+                if (y > maxY)
+                    maxY = y;
+            }
+        }
+    }
+    if (maxX < 0)
+        return null;
+    return { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 };
+}
+//# sourceMappingURL=maskGeometry.js.map

package/dist/io/segmentation/maskGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskGeometry.js","sourceRoot":"","sources":["../../../src/io/segmentation/maskGeometry.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC;SACxC,SAAS,EAAE;SACX,GAAG,EAAE;SACL,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACzC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;gBAC5C,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/io/segmentation/providers/ReplicateSegmentationProvider.d.ts

@@ -0,0 +1,29 @@
+import type { ISegmentationProvider, SegmentationMode, SegmentationRequest, SegmentationResult } from '../types.js';
+export declare class ReplicateSegmentationProvider implements ISegmentationProvider {
+    readonly providerId = "replicate";
+    isInitialized: boolean;
+    defaultModelId?: string;
+    private keyPool;
+    private readonly versionCache;
+    initialize(config: Record<string, unknown>): Promise<void>;
+    supportedModes(): ReadonlyArray<SegmentationMode>;
+    segment(request: SegmentationRequest): Promise<SegmentationResult>;
+    /**
+     * Build the Replicate `input` object for the request's mode. Field names
+     * target the v1 output contract; confirm per chosen model in the smoke step.
+     */
+    private buildInput;
+    private headers;
+    private runPrediction;
+    /**
+     * Resolve a model id to a concrete version hash. An explicit
+     * `owner/name:version` pin is used directly; a bare `owner/name` is looked up
+     * via the model API for its latest version (cached per provider instance).
+     */
+    private resolveVersion;
+    private extractMaskRefs;
+    private fetchMaskBytes;
+    private decodeMasks;
+    private imageDimensions;
+}
+//# sourceMappingURL=ReplicateSegmentationProvider.d.ts.map

package/dist/io/segmentation/providers/ReplicateSegmentationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplicateSegmentationProvider.d.ts","sourceRoot":"","sources":["../../../../src/io/segmentation/providers/ReplicateSegmentationProvider.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,qBAAqB,EAErB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AAsBrB,qBAAa,6BAA8B,YAAW,qBAAqB;IACzE,SAAgB,UAAU,eAAe;IAClC,aAAa,UAAS;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAEpD,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE,cAAc,IAAI,aAAa,CAAC,gBAAgB,CAAC;IAO3C,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6DxE;;;OAGG;IACH,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,OAAO;YAID,aAAa;IAqC3B;;;;OAIG;YACW,cAAc;IA2B5B,OAAO,CAAC,eAAe;YAcT,cAAc;YAWd,WAAW;YAwBX,eAAe;CAK9B"}