@fabric-harness/sdk 0.1.0

package/dist/providers.js

@@ -0,0 +1,265 @@
+import { AnthropicModelProvider, AzureOpenAIModelProvider, BedrockModelProvider, CohereModelProvider, FallbackModelProvider, GeminiModelProvider, MockModelProvider, OpenAICompatibleModelProvider, VertexAIModelProvider } from './model.js';
+export function parseModelRef(model) {
+    const trimmed = model.trim();
+    const slash = trimmed.indexOf('/');
+    if (slash <= 0 || slash === trimmed.length - 1)
+        return undefined;
+    return { provider: trimmed.slice(0, slash), modelId: trimmed.slice(slash + 1), original: trimmed };
+}
+export function resolveModelProvider(options = {}) {
+    const env = options.env ?? process.env;
+    const warnings = [];
+    const production = options.production ?? (env.FABRIC_ENV === 'production' || env.NODE_ENV === 'production');
+    const allowMock = options.allowMock ?? (env.FABRIC_ALLOW_MOCK_MODEL === '1' || env.FABRIC_ALLOW_MOCK_MODEL === 'true');
+    const configuredModel = normalizeModel(options.model) ?? normalizeModel(env.FABRIC_MODEL) ?? legacyOpenAIModel(env, warnings);
+    if (configuredModel === false)
+        return { warnings };
+    if (Array.isArray(configuredModel))
+        return fallbackProvider(configuredModel, options.providers, env, warnings);
+    if (!configuredModel) {
+        if (production && !allowMock)
+            throw new Error('No real model configured in production. Set FABRIC_MODEL=provider/model-id or pass init({ model }).');
+        warnings.push('No model configured; using mock/test-model. Set FABRIC_MODEL=provider/model-id for real model calls.');
+        return { model: 'mock/test-model', provider: new MockModelProvider(), providerName: 'mock', modelId: 'test-model', warnings };
+    }
+    const parsed = parseModelRef(configuredModel);
+    if (!parsed) {
+        if (env.OPENAI_API_KEY) {
+            warnings.push(`Ambiguous model "${configuredModel}"; treating it as openai/${configuredModel}. Prefer FABRIC_MODEL=openai/${configuredModel}.`);
+            return openAIProvider({ provider: 'openai', modelId: configuredModel, original: `openai/${configuredModel}` }, options.providers, env, warnings);
+        }
+        if (production && !allowMock)
+            throw new Error(`Invalid model "${configuredModel}". Use provider/model-id format, e.g. openai/gpt-5.5.`);
+        warnings.push(`Invalid model "${configuredModel}"; using mock/test-model. Use provider/model-id format for real model calls.`);
+        return { model: 'mock/test-model', provider: new MockModelProvider(), providerName: 'mock', modelId: 'test-model', warnings };
+    }
+    if (parsed.provider === 'mock') {
+        if (production && !allowMock)
+            throw new Error('Mock model is disabled in production. Set FABRIC_ALLOW_MOCK_MODEL=1 to allow it explicitly.');
+        if (production)
+            warnings.push('Using mock model in production because FABRIC_ALLOW_MOCK_MODEL is enabled.');
+        return { model: parsed.original, provider: new MockModelProvider(), providerName: 'mock', modelId: parsed.modelId, warnings };
+    }
+    if (parsed.provider === 'openai')
+        return openAIProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'openai-compatible')
+        return openAICompatibleProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'openrouter')
+        return openRouterProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'anthropic')
+        return anthropicProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'azure-openai')
+        return azureOpenAIProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'gemini' || parsed.provider === 'google')
+        return geminiProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'vertex-ai' || parsed.provider === 'vertex')
+        return vertexAIProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'groq')
+        return groqProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'mistral')
+        return mistralProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'cohere')
+        return cohereProvider(parsed, options.providers, env, warnings);
+    if (parsed.provider === 'bedrock' || parsed.provider === 'aws-bedrock')
+        return bedrockProvider(parsed, options.providers, env, warnings);
+    throw new Error(`Unknown model provider "${parsed.provider}" in "${parsed.original}". Supported providers: mock, openai, openai-compatible, openrouter, anthropic, azure-openai, gemini, vertex-ai, groq, mistral, cohere, bedrock.`);
+}
+function fallbackProvider(models, providers, env, warnings) {
+    if (models.length === 0)
+        throw new Error('Model fallback chain must include at least one model.');
+    const resolved = models.map((model) => resolveModelProvider({ model, ...(providers ? { providers } : {}), env, allowMock: true }));
+    for (const item of resolved)
+        warnings.push(...item.warnings);
+    const modelProviders = resolved.map((item) => item.provider).filter((provider) => provider !== undefined);
+    if (modelProviders.length === 0)
+        return { warnings };
+    return {
+        provider: new FallbackModelProvider({ providers: modelProviders }),
+        providerName: 'fallback',
+        modelId: models.join(','),
+        warnings,
+    };
+}
+function openAIProvider(parsed, providers, env, warnings) {
+    const settings = providers?.openai;
+    const apiKey = credential(settings, env, 'OPENAI_API_KEY');
+    if (!apiKey)
+        throw new Error('Missing OpenAI API key. Set OPENAI_API_KEY or providers.openai.apiKey/apiKeyEnv.');
+    return {
+        model: parsed.modelId,
+        provider: new OpenAICompatibleModelProvider({ name: 'openai', baseUrl: settings?.baseUrl ?? env.OPENAI_BASE_URL ?? 'https://api.openai.com/v1', apiKey, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'openai',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function openAICompatibleProvider(parsed, providers, env, warnings) {
+    const settings = providers?.['openai-compatible'];
+    const apiKey = credential(settings, env, 'FABRIC_PROVIDER_API_KEY') ?? env.OPENAI_API_KEY ?? 'dummy';
+    const baseUrl = settings?.baseUrl ?? env.FABRIC_PROVIDER_BASE_URL ?? env.OPENAI_BASE_URL;
+    if (!baseUrl)
+        throw new Error('Missing OpenAI-compatible base URL. Set FABRIC_PROVIDER_BASE_URL or providers.openai-compatible.baseUrl.');
+    return {
+        model: parsed.modelId,
+        provider: new OpenAICompatibleModelProvider({ name: 'openai-compatible', baseUrl, apiKey, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'openai-compatible',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function openRouterProvider(parsed, providers, env, warnings) {
+    const settings = providers?.openrouter;
+    const apiKey = credential(settings, env, 'OPENROUTER_API_KEY');
+    if (!apiKey)
+        throw new Error('Missing OpenRouter API key. Set OPENROUTER_API_KEY or providers.openrouter.apiKey/apiKeyEnv.');
+    const headers = { ...(settings?.headers ?? {}) };
+    if (env.OPENROUTER_REFERER && headers['HTTP-Referer'] === undefined)
+        headers['HTTP-Referer'] = env.OPENROUTER_REFERER;
+    if (env.OPENROUTER_TITLE && headers['X-Title'] === undefined)
+        headers['X-Title'] = env.OPENROUTER_TITLE;
+    return {
+        model: parsed.modelId,
+        provider: new OpenAICompatibleModelProvider({ name: 'openrouter', baseUrl: settings?.baseUrl ?? env.OPENROUTER_BASE_URL ?? 'https://openrouter.ai/api/v1', apiKey, defaultModel: parsed.modelId, headers }),
+        providerName: 'openrouter',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function anthropicProvider(parsed, providers, env, warnings) {
+    const settings = providers?.anthropic;
+    const apiKey = credential(settings, env, 'ANTHROPIC_API_KEY');
+    if (!apiKey)
+        throw new Error('Missing Anthropic API key. Set ANTHROPIC_API_KEY or providers.anthropic.apiKey/apiKeyEnv.');
+    return {
+        model: parsed.modelId,
+        provider: new AnthropicModelProvider({ name: 'anthropic', ...(settings?.baseUrl ? { baseUrl: settings.baseUrl } : {}), apiKey, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'anthropic',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function groqProvider(parsed, providers, env, warnings) {
+    const settings = providers?.groq;
+    const apiKey = credential(settings, env, 'GROQ_API_KEY');
+    if (!apiKey)
+        throw new Error('Missing Groq API key. Set GROQ_API_KEY or providers.groq.apiKey/apiKeyEnv.');
+    return {
+        model: parsed.modelId,
+        provider: new OpenAICompatibleModelProvider({ name: 'groq', baseUrl: settings?.baseUrl ?? env.GROQ_BASE_URL ?? 'https://api.groq.com/openai/v1', apiKey, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'groq',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function mistralProvider(parsed, providers, env, warnings) {
+    const settings = providers?.mistral;
+    const apiKey = credential(settings, env, 'MISTRAL_API_KEY');
+    if (!apiKey)
+        throw new Error('Missing Mistral API key. Set MISTRAL_API_KEY or providers.mistral.apiKey/apiKeyEnv.');
+    return {
+        model: parsed.modelId,
+        provider: new OpenAICompatibleModelProvider({ name: 'mistral', baseUrl: settings?.baseUrl ?? env.MISTRAL_BASE_URL ?? 'https://api.mistral.ai/v1', apiKey, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'mistral',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function geminiProvider(parsed, providers, env, warnings) {
+    const settings = providers?.gemini ?? providers?.google;
+    const apiKey = credential(settings, env, 'GEMINI_API_KEY') ?? env.GOOGLE_API_KEY?.trim();
+    if (!apiKey)
+        throw new Error('Missing Gemini API key. Set GEMINI_API_KEY/GOOGLE_API_KEY or providers.gemini.apiKey/apiKeyEnv.');
+    return {
+        model: parsed.modelId,
+        provider: new GeminiModelProvider({ name: 'gemini', ...(settings?.baseUrl ? { baseUrl: settings.baseUrl } : {}), apiKey, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'gemini',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function vertexAIProvider(parsed, providers, env, warnings) {
+    const settings = providers?.['vertex-ai'] ?? providers?.vertex;
+    const accessToken = credential(settings, env, 'GOOGLE_VERTEX_ACCESS_TOKEN') ?? env.GOOGLE_OAUTH_ACCESS_TOKEN?.trim();
+    if (!accessToken)
+        throw new Error('Missing Vertex AI access token. Set GOOGLE_VERTEX_ACCESS_TOKEN or providers.vertex-ai.apiKey/apiKeyEnv.');
+    const project = settings?.project ?? env.GOOGLE_CLOUD_PROJECT ?? env.GCLOUD_PROJECT;
+    if (!project)
+        throw new Error('Missing Vertex AI project. Set GOOGLE_CLOUD_PROJECT or providers.vertex-ai.project.');
+    return {
+        model: parsed.modelId,
+        provider: new VertexAIModelProvider({ name: 'vertex-ai', project, location: settings?.location ?? env.GOOGLE_CLOUD_LOCATION ?? 'us-central1', accessToken, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'vertex-ai',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function cohereProvider(parsed, providers, env, warnings) {
+    const settings = providers?.cohere;
+    const apiKey = credential(settings, env, 'COHERE_API_KEY');
+    if (!apiKey)
+        throw new Error('Missing Cohere API key. Set COHERE_API_KEY or providers.cohere.apiKey/apiKeyEnv.');
+    return {
+        model: parsed.modelId,
+        provider: new CohereModelProvider({ name: 'cohere', ...(settings?.baseUrl ? { baseUrl: settings.baseUrl } : {}), apiKey, defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'cohere',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function bedrockProvider(parsed, providers, env, warnings) {
+    const settings = providers?.bedrock ?? providers?.['aws-bedrock'];
+    const accessKeyId = credential(settings, env, 'AWS_ACCESS_KEY_ID');
+    const secretAccessKey = settings?.apiKey?.trim() || env[settings?.apiKeyEnv ?? 'AWS_SECRET_ACCESS_KEY']?.trim();
+    if (!accessKeyId || !secretAccessKey)
+        throw new Error('Missing Bedrock credentials. Set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY or providers.bedrock api settings.');
+    const region = settings?.region ?? env.AWS_REGION ?? env.AWS_DEFAULT_REGION;
+    if (!region)
+        throw new Error('Missing Bedrock region. Set AWS_REGION or providers.bedrock.region.');
+    return {
+        model: parsed.modelId,
+        provider: new BedrockModelProvider({ name: 'bedrock', region, accessKeyId, secretAccessKey, ...((settings?.sessionToken ?? env.AWS_SESSION_TOKEN) ? { sessionToken: (settings?.sessionToken ?? env.AWS_SESSION_TOKEN) } : {}), defaultModel: parsed.modelId, ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'bedrock',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function azureOpenAIProvider(parsed, providers, env, warnings) {
+    const settings = providers?.['azure-openai'];
+    const apiKey = credential(settings, env, 'AZURE_OPENAI_API_KEY');
+    if (!apiKey)
+        throw new Error('Missing Azure OpenAI API key. Set AZURE_OPENAI_API_KEY or providers.azure-openai.apiKey/apiKeyEnv.');
+    const baseUrl = settings?.baseUrl ?? env.AZURE_OPENAI_ENDPOINT;
+    if (!baseUrl)
+        throw new Error('Missing Azure OpenAI endpoint. Set AZURE_OPENAI_ENDPOINT or providers.azure-openai.baseUrl.');
+    const apiVersion = env.AZURE_OPENAI_API_VERSION;
+    return {
+        model: parsed.modelId,
+        provider: new AzureOpenAIModelProvider({ name: 'azure-openai', baseUrl, apiKey, deployment: parsed.modelId, ...(apiVersion ? { apiVersion } : {}), ...(settings?.headers ? { headers: settings.headers } : {}) }),
+        providerName: 'azure-openai',
+        modelId: parsed.modelId,
+        warnings,
+    };
+}
+function normalizeModel(value) {
+    if (value === false)
+        return false;
+    if (Array.isArray(value)) {
+        const chain = value.map((item) => item.trim()).filter(Boolean);
+        return chain.length > 0 ? chain : undefined;
+    }
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function legacyOpenAIModel(env, warnings) {
+    const model = env.OPENAI_MODEL?.trim();
+    if (!model)
+        return undefined;
+    warnings.push('OPENAI_MODEL is a legacy shorthand. Prefer FABRIC_MODEL=openai/<model>.');
+    return model.includes('/') ? model : `openai/${model}`;
+}
+function credential(settings, env, defaultEnv) {
+    return settings?.apiKey?.trim() || env[settings?.apiKeyEnv ?? defaultEnv]?.trim();
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/redaction.d.ts

@@ -0,0 +1,11 @@
+import type { JsonObject } from './types.js';
+export interface RedactionOptions {
+    replacement?: string;
+    secretKeyPattern?: RegExp;
+    secretValuePattern?: RegExp;
+    additionalSecrets?: string[];
+}
+export declare function redactText(value: string, options?: RedactionOptions): string;
+export declare function redactJson<T>(value: T, options?: RedactionOptions): T;
+export declare function redactError(error: unknown, options?: RedactionOptions): JsonObject;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAOhF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,CAAC,CAkBzE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAKtF"}

package/dist/redaction.js

@@ -0,0 +1,41 @@
+const DEFAULT_SECRET_KEY_PATTERN = /(?:api[_-]?key|token|secret|password|passwd|credential|authorization|client[_-]?key|private[_-]?key|cert(?:ificate)?)/i;
+const DEFAULT_SECRET_VALUE_PATTERN = /(?:Bearer\s+[A-Za-z0-9._~+/=-]+|sk-[A-Za-z0-9]{16,}|[A-Za-z0-9_\-]{24,}\.[A-Za-z0-9_\-]{12,}\.[A-Za-z0-9_\-]{12,})/g;
+export function redactText(value, options = {}) {
+    const replacement = options.replacement ?? '[REDACTED]';
+    let redacted = value.replace(options.secretValuePattern ?? DEFAULT_SECRET_VALUE_PATTERN, replacement);
+    for (const secret of options.additionalSecrets ?? []) {
+        if (secret)
+            redacted = redacted.split(secret).join(replacement);
+    }
+    return redacted;
+}
+export function redactJson(value, options = {}) {
+    const replacement = options.replacement ?? '[REDACTED]';
+    const keyPattern = options.secretKeyPattern ?? DEFAULT_SECRET_KEY_PATTERN;
+    const seen = new WeakSet();
+    const visit = (item, key) => {
+        if (key && keyPattern.test(key))
+            return replacement;
+        if (typeof item === 'string')
+            return redactText(item, options);
+        if (item === null || typeof item !== 'object')
+            return item;
+        if (seen.has(item))
+            return '[Circular]';
+        seen.add(item);
+        if (Array.isArray(item))
+            return item.map((entry) => visit(entry));
+        const output = {};
+        for (const [entryKey, entryValue] of Object.entries(item))
+            output[entryKey] = visit(entryValue, entryKey);
+        return output;
+    };
+    return visit(value);
+}
+export function redactError(error, options = {}) {
+    if (error instanceof Error) {
+        return redactJson({ name: error.name, message: error.message, stack: error.stack }, options);
+    }
+    return redactJson({ error: String(error) }, options);
+}
+//# sourceMappingURL=redaction.js.map

package/dist/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAEA,MAAM,0BAA0B,GAAG,wHAAwH,CAAC;AAC5J,MAAM,4BAA4B,GAAG,qHAAqH,CAAC;AAS3J,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAA4B,EAAE;IACtE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;IACxD,IAAI,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,IAAI,4BAA4B,EAAE,WAAW,CAAC,CAAC;IACtG,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACrD,IAAI,MAAM;YAAE,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,KAAQ,EAAE,UAA4B,EAAE;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAC1E,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IAEnC,MAAM,KAAK,GAAG,CAAC,IAAa,EAAE,GAAY,EAAW,EAAE;QACrD,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,WAAW,CAAC;QACpD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3D,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,YAAY,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC1G,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,KAAK,CAAC,KAAK,CAAM,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,UAA4B,EAAE;IACxE,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,CAAe,CAAC;IAC7G,CAAC;IACD,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAe,CAAC;AACrE,CAAC"}

package/dist/result.d.ts

@@ -0,0 +1,7 @@
+import type { ResultExtractionOptions, ResultValidator } from './types.js';
+export declare const RESULT_START_DELIMITER = "---RESULT_START---";
+export declare const RESULT_END_DELIMITER = "---RESULT_END---";
+export declare function validateResult<TResult>(value: unknown, validator?: ResultValidator<TResult>, extraction?: boolean | ResultExtractionOptions): Promise<TResult>;
+export declare function extractResultValue(value: unknown, extraction?: boolean | ResultExtractionOptions): unknown;
+export declare function buildResultRetryPrompt(error: unknown, extraction?: boolean | ResultExtractionOptions): string;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,wBAAsB,cAAc,CAAC,OAAO,EAC1C,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,EACpC,UAAU,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC7C,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAE,OAAO,GAAG,uBAA8B,GAAG,OAAO,CAuBhH;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAE,OAAO,GAAG,uBAA8B,GAAG,MAAM,CAanH"}

package/dist/result.js

@@ -0,0 +1,105 @@
+import { FabricError } from './error.js';
+export const RESULT_START_DELIMITER = '---RESULT_START---';
+export const RESULT_END_DELIMITER = '---RESULT_END---';
+export async function validateResult(value, validator, extraction) {
+    const candidate = extractResultValue(value, extraction ?? Boolean(validator));
+    if (!validator) {
+        return candidate;
+    }
+    try {
+        if (validator.parse) {
+            return validator.parse(candidate);
+        }
+        if (validator.safeParse) {
+            const result = validator.safeParse(candidate);
+            if (result.success) {
+                return result.data;
+            }
+            throw result.error;
+        }
+        if (validator.validate) {
+            return validator.validate(candidate);
+        }
+    }
+    catch (error) {
+        throw normalizeValidationError(error);
+    }
+    return candidate;
+}
+export function extractResultValue(value, extraction = true) {
+    if (!extraction || typeof value !== 'string')
+        return value;
+    const options = typeof extraction === 'object' ? extraction : {};
+    const startDelimiter = options.startDelimiter ?? RESULT_START_DELIMITER;
+    const endDelimiter = options.endDelimiter ?? RESULT_END_DELIMITER;
+    const parseJson = options.parseJson ?? true;
+    const required = options.required ?? false;
+    const text = value.trim();
+    const delimited = extractDelimitedText(text, startDelimiter, endDelimiter);
+    if (delimited !== undefined)
+        return parseJson ? parseJsonPayload(delimited) : delimited;
+    if (required) {
+        throw new FabricError({
+            code: 'RESULT_VALIDATION_FAILED',
+            message: `Missing typed result delimiters: ${startDelimiter} ... ${endDelimiter}`,
+            details: { startDelimiter, endDelimiter },
+            retryable: true,
+        });
+    }
+    if (parseJson && looksLikeJson(text))
+        return parseJsonPayload(text);
+    return value;
+}
+export function buildResultRetryPrompt(error, extraction = true) {
+    const options = typeof extraction === 'object' ? extraction : {};
+    const startDelimiter = options.startDelimiter ?? RESULT_START_DELIMITER;
+    const endDelimiter = options.endDelimiter ?? RESULT_END_DELIMITER;
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return [
+        'Your previous response could not be parsed or validated as the required typed result.',
+        `Validation error: ${errorMessage}`,
+        'Return the corrected result only, with no extra commentary, using this exact format:',
+        startDelimiter,
+        '{"example":"replace with the valid JSON result"}',
+        endDelimiter,
+    ].join('\n');
+}
+function extractDelimitedText(text, startDelimiter, endDelimiter) {
+    const start = text.indexOf(startDelimiter);
+    if (start === -1)
+        return undefined;
+    const payloadStart = start + startDelimiter.length;
+    const end = text.indexOf(endDelimiter, payloadStart);
+    if (end === -1) {
+        throw new FabricError({
+            code: 'RESULT_VALIDATION_FAILED',
+            message: `Missing typed result end delimiter: ${endDelimiter}`,
+            details: { startDelimiter, endDelimiter },
+            retryable: true,
+        });
+    }
+    return text.slice(payloadStart, end).trim();
+}
+function parseJsonPayload(payload) {
+    try {
+        return JSON.parse(payload);
+    }
+    catch (error) {
+        throw new FabricError({
+            code: 'RESULT_VALIDATION_FAILED',
+            message: `Failed to parse typed result JSON: ${error instanceof Error ? error.message : String(error)}`,
+            details: { payload: payload.slice(0, 500) },
+            cause: error,
+            retryable: true,
+        });
+    }
+}
+function looksLikeJson(text) {
+    return (text.startsWith('{') && text.endsWith('}')) || (text.startsWith('[') && text.endsWith(']')) || text === 'null' || /^-?\d+(\.\d+)?$/.test(text) || text === 'true' || text === 'false';
+}
+function normalizeValidationError(error) {
+    if (error instanceof Error)
+        return error;
+    return new FabricError({ code: 'RESULT_VALIDATION_FAILED', message: String(error), details: { error: String(error) }, retryable: true });
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

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

package/dist/runtime-mode.d.ts

@@ -0,0 +1,30 @@
+import type { AgentInit, FabricRuntime, SessionStore } from './types.js';
+export interface RuntimeModeResolution {
+    runtime: FabricRuntime;
+    warnings: string[];
+    /**
+     * True when the agent should not persist any session state, artifacts,
+     * approvals, or events to disk / external store.
+     */
+    ephemeral: boolean;
+}
+/**
+ * Resolve the effective runtime mode for an `init()` call, applying
+ * production safety rules:
+ *
+ * - In production (`FABRIC_ENV=production` or `NODE_ENV=production`),
+ *   choosing `stateless` is allowed but logged as an explicit choice.
+ * - `inline` (the default) without an explicit `SessionStore` falls
+ *   back to in-memory storage. In production this emits a warning unless
+ *   `FABRIC_ALLOW_EPHEMERAL_STATE=1` is set or runtime is explicitly
+ *   `'stateless'`.
+ * - Unknown runtime values fall through to `'inline'` with a warning.
+ */
+export declare function resolveRuntimeMode(options: Pick<AgentInit, 'runtime' | 'store'>, env?: Record<string, string | undefined>): RuntimeModeResolution;
+export declare function isStatelessRuntime(runtime: FabricRuntime | undefined): boolean;
+/**
+ * Returns true when `store` is the in-memory default (no `appendEntry`
+ * persistence beyond memory). Used by stateless mode to skip writes.
+ */
+export declare function isInMemoryStore(store: SessionStore | undefined): boolean;
+//# sourceMappingURL=runtime-mode.d.ts.map

package/dist/runtime-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mode.d.ts","sourceRoot":"","sources":["../src/runtime-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,EAC7C,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,qBAAqB,CAsBvB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAE9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAGxE"}

package/dist/runtime-mode.js

@@ -0,0 +1,42 @@
+/**
+ * Resolve the effective runtime mode for an `init()` call, applying
+ * production safety rules:
+ *
+ * - In production (`FABRIC_ENV=production` or `NODE_ENV=production`),
+ *   choosing `stateless` is allowed but logged as an explicit choice.
+ * - `inline` (the default) without an explicit `SessionStore` falls
+ *   back to in-memory storage. In production this emits a warning unless
+ *   `FABRIC_ALLOW_EPHEMERAL_STATE=1` is set or runtime is explicitly
+ *   `'stateless'`.
+ * - Unknown runtime values fall through to `'inline'` with a warning.
+ */
+export function resolveRuntimeMode(options, env = process.env) {
+    const warnings = [];
+    const requested = options.runtime;
+    const production = env.FABRIC_ENV === 'production' || env.NODE_ENV === 'production';
+    const allowEphemeral = env.FABRIC_ALLOW_EPHEMERAL_STATE === '1' || env.FABRIC_ALLOW_EPHEMERAL_STATE === 'true';
+    let runtime = requested ?? 'inline';
+    if (runtime !== 'inline' && runtime !== 'stateless' && runtime !== 'temporal') {
+        warnings.push(`Unknown runtime "${String(runtime)}"; defaulting to "inline".`);
+        runtime = 'inline';
+    }
+    const ephemeral = runtime === 'stateless' || (runtime === 'inline' && options.store === undefined);
+    if (production && ephemeral && runtime === 'inline' && !allowEphemeral) {
+        warnings.push('Inline runtime in production without an explicit SessionStore — session history is in-memory only and will not survive restarts. ' +
+            'Configure a SessionStore (SQLite/Postgres/file), set runtime: "stateless" to opt in explicitly, or set FABRIC_ALLOW_EPHEMERAL_STATE=1.');
+    }
+    return { runtime, warnings, ephemeral };
+}
+export function isStatelessRuntime(runtime) {
+    return runtime === 'stateless';
+}
+/**
+ * Returns true when `store` is the in-memory default (no `appendEntry`
+ * persistence beyond memory). Used by stateless mode to skip writes.
+ */
+export function isInMemoryStore(store) {
+    if (!store)
+        return true;
+    return store.__inMemory === true;
+}
+//# sourceMappingURL=runtime-mode.js.map

package/dist/runtime-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mode.js","sourceRoot":"","sources":["../src/runtime-mode.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA6C,EAC7C,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAClC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,KAAK,YAAY,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IACpF,MAAM,cAAc,GAAG,GAAG,CAAC,4BAA4B,KAAK,GAAG,IAAI,GAAG,CAAC,4BAA4B,KAAK,MAAM,CAAC;IAE/G,IAAI,OAAO,GAAkB,SAAS,IAAI,QAAQ,CAAC;IACnD,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC9E,QAAQ,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC/E,OAAO,GAAG,QAAQ,CAAC;IACrB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAEnG,IAAI,UAAU,IAAI,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC;QACvE,QAAQ,CAAC,IAAI,CACX,mIAAmI;YACjI,wIAAwI,CAC3I,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,OAAO,OAAO,KAAK,WAAW,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAA+B;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAQ,KAAkC,CAAC,UAAU,KAAK,IAAI,CAAC;AACjE,CAAC"}