@sdlcagent/agent-sdk 1.0.0

package/dist/envelopes/sub-types/TriggerPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerPayload.js","sourceRoot":"","sources":["../../../src/envelopes/sub-types/TriggerPayload.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { AgentServer, createApp } from './AgentServer';
+export type { AgentHandler, AgentServerOptions } from './AgentServer';
+export type { ContextEnvelope, RunMode } from './envelopes/ContextEnvelope';
+export { parseContextEnvelope } from './envelopes/ContextEnvelope';
+export type { ResultEnvelope, StepStatus } from './envelopes/ResultEnvelope';
+export { validateResultEnvelope } from './envelopes/ResultEnvelope';
+export { AgentError, ContextEnvelopeParseError, ResultEnvelopeValidationError } from './AgentError';
+export type { AgentErrorCode } from './AgentError';
+export type { TriggerPayload } from './envelopes/sub-types/TriggerPayload';
+export type { EffectivePolicy } from './envelopes/sub-types/EffectivePolicy';
+export type { PromptRef } from './envelopes/sub-types/PromptRef';
+export type { RedactionProfile } from './envelopes/sub-types/RedactionProfile';
+export type { MemoryRefs, MemoryRecord } from './envelopes/sub-types/MemoryRefs';
+export type { ActionRequest } from './envelopes/sub-types/ActionRequest';
+export type { ArtifactRef } from './envelopes/sub-types/ArtifactRef';
+export type { CriticSignal, CriticCheck, CriticSeverity } from './envelopes/sub-types/CriticSignal';
+export type { HitlOption } from './envelopes/sub-types/HitlTypes';
+export type { MemorySignal, MemorySignalType, MemorySignalScope, } from './envelopes/sub-types/MemorySignal';
+export type { AgentMetrics } from './envelopes/sub-types/AgentMetrics';
+export { logger } from './logger';
+export type { Logger, LogContext } from './logger';
+export { emitLog } from './logging/emitLog';
+export type { LogLevel, EmitLogOptions } from './logging/emitLog';
+export { AGENT_PHASES } from './logging/phases';
+export type { AgentPhase } from './logging/phases';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEtE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACpG,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,YAAY,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,YAAY,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpG,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_PHASES = exports.emitLog = exports.logger = exports.ResultEnvelopeValidationError = exports.ContextEnvelopeParseError = exports.AgentError = exports.validateResultEnvelope = exports.parseContextEnvelope = exports.createApp = exports.AgentServer = void 0;
+var AgentServer_1 = require("./AgentServer");
+Object.defineProperty(exports, "AgentServer", { enumerable: true, get: function () { return AgentServer_1.AgentServer; } });
+Object.defineProperty(exports, "createApp", { enumerable: true, get: function () { return AgentServer_1.createApp; } });
+var ContextEnvelope_1 = require("./envelopes/ContextEnvelope");
+Object.defineProperty(exports, "parseContextEnvelope", { enumerable: true, get: function () { return ContextEnvelope_1.parseContextEnvelope; } });
+var ResultEnvelope_1 = require("./envelopes/ResultEnvelope");
+Object.defineProperty(exports, "validateResultEnvelope", { enumerable: true, get: function () { return ResultEnvelope_1.validateResultEnvelope; } });
+var AgentError_1 = require("./AgentError");
+Object.defineProperty(exports, "AgentError", { enumerable: true, get: function () { return AgentError_1.AgentError; } });
+Object.defineProperty(exports, "ContextEnvelopeParseError", { enumerable: true, get: function () { return AgentError_1.ContextEnvelopeParseError; } });
+Object.defineProperty(exports, "ResultEnvelopeValidationError", { enumerable: true, get: function () { return AgentError_1.ResultEnvelopeValidationError; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+var emitLog_1 = require("./logging/emitLog");
+Object.defineProperty(exports, "emitLog", { enumerable: true, get: function () { return emitLog_1.emitLog; } });
+var phases_1 = require("./logging/phases");
+Object.defineProperty(exports, "AGENT_PHASES", { enumerable: true, get: function () { return phases_1.AGENT_PHASES; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAAuD;AAA9C,0GAAA,WAAW,OAAA;AAAE,wGAAA,SAAS,OAAA;AAI/B,+DAAmE;AAA1D,uHAAA,oBAAoB,OAAA;AAG7B,6DAAoE;AAA3D,wHAAA,sBAAsB,OAAA;AAE/B,2CAAoG;AAA3F,wGAAA,UAAU,OAAA;AAAE,uHAAA,yBAAyB,OAAA;AAAE,2HAAA,6BAA6B,OAAA;AAmB7E,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAGf,6CAA4C;AAAnC,kGAAA,OAAO,OAAA;AAEhB,2CAAgD;AAAvC,sGAAA,YAAY,OAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,32 @@
+/** Fields automatically included in every log entry within a withContext() scope. */
+export interface LogContext {
+    run_id?: string;
+    org_id?: string;
+    project_id?: string;
+    step_id?: string;
+    agent_id?: string;
+}
+export interface Logger {
+    debug(data: Record<string, unknown>): void;
+    info(data: Record<string, unknown>): void;
+    warn(data: Record<string, unknown>): void;
+    error(data: Record<string, unknown>): void;
+    /**
+     * Runs fn with ctx merged into every log call in that async chain.
+     * Merges with any outer context (inner fields win on conflict).
+     */
+    withContext<T>(ctx: LogContext, fn: () => T): T;
+    /**
+     * Returns a new logger with extra fields always merged into every entry.
+     * Stacks with AsyncLocalStorage context — child fields take precedence.
+     */
+    child(fields: Record<string, unknown>): Logger;
+    /**
+     * Wraps a sync or async step with STEP_START / STEP_END log entries.
+     * Logs STEP_ERROR (with duration_ms) and rethrows on failure.
+     * All log entries carry the current AsyncLocalStorage context.
+     */
+    time<T>(step: string, fn: () => T | Promise<T>, extra?: Record<string, unknown>): Promise<Awaited<T>>;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAOA,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACvG;AA0DD,eAAO,MAAM,MAAM,EAAE,MAAqB,CAAC"}

package/dist/logger.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+const currentLevel = LEVELS[(process.env['LOG_LEVEL'] ?? 'info')] ?? 1;
+const contextStorage = new node_async_hooks_1.AsyncLocalStorage();
+function emit(level, fixedFields, data) {
+    if (LEVELS[level] < currentLevel)
+        return;
+    const ctx = contextStorage.getStore() ?? {};
+    process.stdout.write(JSON.stringify({ timestamp: new Date().toISOString(), level, ...ctx, ...fixedFields, ...data }) +
+        '\n');
+}
+function makeLogger(fixedFields = {}) {
+    return {
+        debug: (d) => emit('debug', fixedFields, d),
+        info: (d) => emit('info', fixedFields, d),
+        warn: (d) => emit('warn', fixedFields, d),
+        error: (d) => emit('error', fixedFields, d),
+        withContext(ctx, fn) {
+            const outer = contextStorage.getStore() ?? {};
+            return contextStorage.run({ ...outer, ...ctx }, fn);
+        },
+        child(moreFields) {
+            return makeLogger({ ...fixedFields, ...moreFields });
+        },
+        async time(step, fn, extra) {
+            emit('info', fixedFields, { event: 'STEP_START', step, ...extra });
+            const t = Date.now();
+            try {
+                const result = await fn();
+                emit('info', fixedFields, { event: 'STEP_END', step, duration_ms: Date.now() - t, ...extra });
+                return result;
+            }
+            catch (err) {
+                emit('error', fixedFields, {
+                    event: 'STEP_ERROR',
+                    step,
+                    duration_ms: Date.now() - t,
+                    error: err instanceof Error ? err.message : String(err),
+                    ...extra,
+                });
+                throw err;
+            }
+        },
+    };
+}
+exports.logger = makeLogger();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/logging/emitLog.d.ts

@@ -0,0 +1,11 @@
+import type { ContextEnvelope } from '../envelopes/ContextEnvelope';
+import type { AgentPhase } from './phases';
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+export interface EmitLogOptions {
+    level?: LogLevel;
+    meta?: Record<string, unknown>;
+    ts?: string;
+    timeoutMs?: number;
+}
+export declare function emitLog(ctx: ContextEnvelope, phase: AgentPhase, message: string, opts?: EmitLogOptions): Promise<void>;
+//# sourceMappingURL=emitLog.d.ts.map

package/dist/logging/emitLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitLog.d.ts","sourceRoot":"","sources":["../../src/logging/emitLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAsB,OAAO,CAC3B,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/logging/emitLog.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitLog = emitLog;
+const DEFAULT_TIMEOUT_MS = 3000;
+const MAX_MESSAGE_CHARS = 1000;
+async function emitLog(ctx, phase, message, opts) {
+    if (!ctx?.log_callback_url || !ctx?.step_token)
+        return;
+    const { level = 'INFO', meta, ts = new Date().toISOString(), timeoutMs = DEFAULT_TIMEOUT_MS, } = opts ?? {};
+    try {
+        await fetch(ctx.log_callback_url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${ctx.step_token}`,
+            },
+            body: JSON.stringify({
+                component: 'agent',
+                phase,
+                level,
+                message: message.slice(0, MAX_MESSAGE_CHARS),
+                meta,
+                ts,
+            }),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    catch {
+    }
+}
+//# sourceMappingURL=emitLog.js.map

package/dist/logging/emitLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitLog.js","sourceRoot":"","sources":["../../src/logging/emitLog.ts"],"names":[],"mappings":";;AAeA,0BAiCC;AApCD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAExB,KAAK,UAAU,OAAO,CAC3B,GAAoB,EACpB,KAAiB,EACjB,OAAe,EACf,IAAqB;IAErB,IAAI,CAAC,GAAG,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,UAAU;QAAE,OAAO;IACvD,MAAM,EACJ,KAAK,GAAG,MAAM,EACd,IAAI,EACJ,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAC7B,SAAS,GAAG,kBAAkB,GAC/B,GAAG,IAAI,IAAI,EAAE,CAAC;IAEf,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,GAAG,CAAC,UAAU,EAAE;aAC1C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,OAAO;gBAClB,KAAK;gBACL,KAAK;gBACL,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC;gBAC5C,IAAI;gBACJ,EAAE;aACH,CAAC;YACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;IACT,CAAC;AACH,CAAC"}

package/dist/logging/phases.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_PHASES: readonly ["context_parse", "llm_invoke", "llm_complete", "critic_tier1", "critic_tier2", "tool_call", "artifact_write", "result_emit"];
+export type AgentPhase = (typeof AGENT_PHASES)[number];
+//# sourceMappingURL=phases.d.ts.map

package/dist/logging/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../src/logging/phases.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY,wIASf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/logging/phases.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_PHASES = void 0;
+exports.AGENT_PHASES = [
+    'context_parse',
+    'llm_invoke',
+    'llm_complete',
+    'critic_tier1',
+    'critic_tier2',
+    'tool_call',
+    'artifact_write',
+    'result_emit',
+];
+//# sourceMappingURL=phases.js.map

package/dist/logging/phases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.js","sourceRoot":"","sources":["../../src/logging/phases.ts"],"names":[],"mappings":";;;AACa,QAAA,YAAY,GAAG;IAC1B,eAAe;IACf,YAAY;IACZ,cAAc;IACd,cAAc;IACd,cAAc;IACd,WAAW;IACX,gBAAgB;IAChB,aAAa;CACL,CAAC"}

package/dist/server-utils.d.ts

@@ -0,0 +1,6 @@
+export declare function readManifest(raw: unknown): {
+    agent_id: string;
+    version: string;
+};
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T>;
+//# sourceMappingURL=server-utils.d.ts.map

package/dist/server-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-utils.d.ts","sourceRoot":"","sources":["../src/server-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAchF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/server-utils.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readManifest = readManifest;
+exports.withTimeout = withTimeout;
+function readManifest(raw) {
+    if (typeof raw === 'object' &&
+        raw !== null &&
+        'agent_id' in raw &&
+        typeof raw.agent_id === 'string' &&
+        'version' in raw &&
+        typeof raw.version === 'string') {
+        return raw;
+    }
+    throw new Error('agent.manifest.json must be provided with at least agent_id and version fields');
+}
+function withTimeout(promise, timeoutMs, label) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs)),
+    ]);
+}
+//# sourceMappingURL=server-utils.js.map

package/dist/server-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-utils.js","sourceRoot":"","sources":["../src/server-utils.ts"],"names":[],"mappings":";;AAAA,oCAcC;AAED,kCAcC;AA9BD,SAAgB,YAAY,CAAC,GAAY;IACvC,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,UAAU,IAAI,GAAG;QACjB,OAAQ,GAA6B,CAAC,QAAQ,KAAK,QAAQ;QAC3D,SAAS,IAAI,GAAG;QAChB,OAAQ,GAA4B,CAAC,OAAO,KAAK,QAAQ,EACzD,CAAC;QACD,OAAO,GAA4C,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CACzB,OAAmB,EACnB,SAAiB,EACjB,KAAa;IAEb,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CACR,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,SAAS,IAAI,CAAC,CAAC,EAClE,SAAS,CACV,CACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,311 @@
+import { z } from 'zod';
+export declare const contextEnvelopeSchema: z.ZodObject<{
+    org_id: z.ZodString;
+    project_id: z.ZodString;
+    team_id: z.ZodString;
+    run_id: z.ZodString;
+    step_id: z.ZodString;
+    workflow_type: z.ZodString;
+    run_mode: z.ZodEnum<["CREATE", "MODIFY_ENHANCE"]>;
+    trigger: z.ZodObject<{
+        source: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        payload: Record<string, unknown>;
+    }, {
+        source: string;
+        payload: Record<string, unknown>;
+    }>;
+    work_item_context: z.ZodString;
+    policy_snapshot: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    prompt_refs: z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        rendered: z.ZodString;
+        prompt_id: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        binding_key: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        rendered: string;
+        prompt_id?: string | undefined;
+        version?: string | undefined;
+        binding_key?: string | undefined;
+    }, {
+        role: string;
+        rendered: string;
+        prompt_id?: string | undefined;
+        version?: string | undefined;
+        binding_key?: string | undefined;
+    }>, "many">;
+    redaction_profile: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    memory_refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    agent_config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    log_callback_url: z.ZodString;
+    step_token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    org_id: string;
+    project_id: string;
+    team_id: string;
+    run_id: string;
+    step_id: string;
+    workflow_type: string;
+    run_mode: "CREATE" | "MODIFY_ENHANCE";
+    trigger: {
+        source: string;
+        payload: Record<string, unknown>;
+    };
+    work_item_context: string;
+    policy_snapshot: Record<string, unknown>;
+    prompt_refs: {
+        role: string;
+        rendered: string;
+        prompt_id?: string | undefined;
+        version?: string | undefined;
+        binding_key?: string | undefined;
+    }[];
+    redaction_profile: Record<string, unknown>;
+    agent_config: Record<string, unknown>;
+    log_callback_url: string;
+    step_token: string;
+    memory_refs?: Record<string, unknown> | undefined;
+}, {
+    org_id: string;
+    project_id: string;
+    team_id: string;
+    run_id: string;
+    step_id: string;
+    workflow_type: string;
+    run_mode: "CREATE" | "MODIFY_ENHANCE";
+    trigger: {
+        source: string;
+        payload: Record<string, unknown>;
+    };
+    work_item_context: string;
+    policy_snapshot: Record<string, unknown>;
+    prompt_refs: {
+        role: string;
+        rendered: string;
+        prompt_id?: string | undefined;
+        version?: string | undefined;
+        binding_key?: string | undefined;
+    }[];
+    redaction_profile: Record<string, unknown>;
+    agent_config: Record<string, unknown>;
+    log_callback_url: string;
+    step_token: string;
+    memory_refs?: Record<string, unknown> | undefined;
+}>;
+export declare const resultEnvelopeSchema: z.ZodObject<{
+    status: z.ZodEnum<["SUCCEEDED", "FAILED", "HITL_REQUIRED"]>;
+    summary: z.ZodString;
+    output_data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    action_requests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        action_id: z.ZodString;
+        action_key: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        action_id: string;
+        action_key: string;
+        parameters: Record<string, unknown>;
+        required?: boolean | undefined;
+    }, {
+        action_id: string;
+        action_key: string;
+        parameters: Record<string, unknown>;
+        required?: boolean | undefined;
+    }>, "many">>;
+    artifacts_created: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        artifact_id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        artifact_id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        artifact_id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    critic_signal: z.ZodOptional<z.ZodObject<{
+        scorecard_id: z.ZodString;
+        overall: z.ZodEnum<["PASS", "WARN", "FAIL"]>;
+        checks: z.ZodArray<z.ZodObject<{
+            check_id: z.ZodString;
+            label: z.ZodString;
+            severity: z.ZodEnum<["INFO", "WARN", "ERROR"]>;
+            passed: z.ZodBoolean;
+            detail: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            check_id: string;
+            severity: "INFO" | "WARN" | "ERROR";
+            passed: boolean;
+            detail?: string | undefined;
+        }, {
+            label: string;
+            check_id: string;
+            severity: "INFO" | "WARN" | "ERROR";
+            passed: boolean;
+            detail?: string | undefined;
+        }>, "many">;
+        score: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        scorecard_id: string;
+        overall: "WARN" | "PASS" | "FAIL";
+        checks: {
+            label: string;
+            check_id: string;
+            severity: "INFO" | "WARN" | "ERROR";
+            passed: boolean;
+            detail?: string | undefined;
+        }[];
+        score?: number | undefined;
+    }, {
+        scorecard_id: string;
+        overall: "WARN" | "PASS" | "FAIL";
+        checks: {
+            label: string;
+            check_id: string;
+            severity: "INFO" | "WARN" | "ERROR";
+            passed: boolean;
+            detail?: string | undefined;
+        }[];
+        score?: number | undefined;
+    }>>;
+    hitl_reason: z.ZodOptional<z.ZodString>;
+    hitl_options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        description: string;
+        value?: string | undefined;
+    }, {
+        label: string;
+        description: string;
+        value?: string | undefined;
+    }>, "many">>;
+    remember: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["episodic", "semantic", "procedural"]>;
+        scope: z.ZodEnum<["workflow", "project", "tenant", "global"]>;
+        content: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ttl_days: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "episodic" | "semantic" | "procedural";
+        scope: "workflow" | "project" | "tenant" | "global";
+        content: string;
+        tags?: string[] | undefined;
+        ttl_days?: number | undefined;
+    }, {
+        type: "episodic" | "semantic" | "procedural";
+        scope: "workflow" | "project" | "tenant" | "global";
+        content: string;
+        tags?: string[] | undefined;
+        ttl_days?: number | undefined;
+    }>, "many">>;
+    agent_summary: z.ZodOptional<z.ZodString>;
+    next_step_hint: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    status: "SUCCEEDED" | "FAILED" | "HITL_REQUIRED";
+    summary: string;
+    output_data?: Record<string, unknown> | undefined;
+    action_requests?: {
+        action_id: string;
+        action_key: string;
+        parameters: Record<string, unknown>;
+        required?: boolean | undefined;
+    }[] | undefined;
+    artifacts_created?: z.objectOutputType<{
+        artifact_id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+    critic_signal?: {
+        scorecard_id: string;
+        overall: "WARN" | "PASS" | "FAIL";
+        checks: {
+            label: string;
+            check_id: string;
+            severity: "INFO" | "WARN" | "ERROR";
+            passed: boolean;
+            detail?: string | undefined;
+        }[];
+        score?: number | undefined;
+    } | undefined;
+    hitl_reason?: string | undefined;
+    hitl_options?: {
+        label: string;
+        description: string;
+        value?: string | undefined;
+    }[] | undefined;
+    remember?: {
+        type: "episodic" | "semantic" | "procedural";
+        scope: "workflow" | "project" | "tenant" | "global";
+        content: string;
+        tags?: string[] | undefined;
+        ttl_days?: number | undefined;
+    }[] | undefined;
+    agent_summary?: string | undefined;
+    next_step_hint?: string | undefined;
+    metrics?: Record<string, unknown> | undefined;
+}, {
+    status: "SUCCEEDED" | "FAILED" | "HITL_REQUIRED";
+    summary: string;
+    output_data?: Record<string, unknown> | undefined;
+    action_requests?: {
+        action_id: string;
+        action_key: string;
+        parameters: Record<string, unknown>;
+        required?: boolean | undefined;
+    }[] | undefined;
+    artifacts_created?: z.objectInputType<{
+        artifact_id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+    critic_signal?: {
+        scorecard_id: string;
+        overall: "WARN" | "PASS" | "FAIL";
+        checks: {
+            label: string;
+            check_id: string;
+            severity: "INFO" | "WARN" | "ERROR";
+            passed: boolean;
+            detail?: string | undefined;
+        }[];
+        score?: number | undefined;
+    } | undefined;
+    hitl_reason?: string | undefined;
+    hitl_options?: {
+        label: string;
+        description: string;
+        value?: string | undefined;
+    }[] | undefined;
+    remember?: {
+        type: "episodic" | "semantic" | "procedural";
+        scope: "workflow" | "project" | "tenant" | "global";
+        content: string;
+        tags?: string[] | undefined;
+        ttl_days?: number | undefined;
+    }[] | undefined;
+    agent_summary?: string | undefined;
+    next_step_hint?: string | undefined;
+    metrics?: Record<string, unknown> | undefined;
+}>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBhC,CAAC;AAgDH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC"}