@xemahq/contracts 0.81.0 → 0.83.0

package/dist/revision-target/lib/revision-target.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OwnerQualifiedRevisionTargetSchema = exports.RevisionTargetSchema = exports.RELEASE_CHANNEL_PATTERN = exports.REVISION_RESOURCE_KIND_PATTERN = void 0;
 exports.ownerQualifiedRevisionTargetKey = ownerQualifiedRevisionTargetKey;
 exports.revisionTargetKey = revisionTargetKey;
+exports.logicalResourceId = logicalResourceId;
+exports.parseLogicalResourceId = parseLogicalResourceId;
 const zod_1 = require("zod");
 const content_address_1 = require("../../content-address");
 const space_1 = require("../../space");
@@ -10,19 +12,19 @@ const OPAQUE_REF = zod_1.z
     .string()
     .min(1)
     .max(2_048)
-    .regex(content_address_1.OPAQUE_TOKEN_PATTERN, 'reference must be opaque and contain no whitespace or control characters');
+    .regex(content_address_1.OPAQUE_TOKEN_PATTERN, "reference must be opaque and contain no whitespace or control characters");
 exports.REVISION_RESOURCE_KIND_PATTERN = /^[a-z][a-z0-9-]{0,62}$/u;
 exports.RELEASE_CHANNEL_PATTERN = /^[a-z][a-z0-9-]{0,62}$/u;
 const ExactRevisionSelectorSchema = zod_1.z
     .object({
-    kind: zod_1.z.literal('exact'),
+    kind: zod_1.z.literal("exact"),
     revisionId: OPAQUE_REF,
     contentHash: content_address_1.Sha256HexSchema,
 })
     .strict();
 const ReleaseChannelRevisionSelectorSchema = zod_1.z
     .object({
-    kind: zod_1.z.literal('release-channel'),
+    kind: zod_1.z.literal("release-channel"),
     channel: zod_1.z.string().regex(exports.RELEASE_CHANNEL_PATTERN),
 })
     .strict();
@@ -30,7 +32,7 @@ exports.RevisionTargetSchema = zod_1.z
     .object({
     resourceKind: zod_1.z.string().regex(exports.REVISION_RESOURCE_KIND_PATTERN),
     resourceId: OPAQUE_REF,
-    selector: zod_1.z.discriminatedUnion('kind', [
+    selector: zod_1.z.discriminatedUnion("kind", [
         ExactRevisionSelectorSchema,
         ReleaseChannelRevisionSelectorSchema,
     ]),
@@ -46,9 +48,28 @@ function ownerQualifiedRevisionTargetKey(value) {
     return `${(0, space_1.formatOwnerSpaceKey)(value.ownerSpaceRef)}:${revisionTargetKey(value.target)}`;
 }
 function revisionTargetKey(target) {
-    const selector = target.selector.kind === 'exact'
+    const selector = target.selector.kind === "exact"
         ? `exact:${target.selector.revisionId}:${target.selector.contentHash}`
         : `release-channel:${target.selector.channel}`;
     return `${target.resourceKind}:${target.resourceId}:${selector}`;
 }
+const LOGICAL_RESOURCE_ID_SEPARATOR = "#";
+function logicalResourceId(ref) {
+    if (ref.slug.length === 0 ||
+        ref.slug.includes(LOGICAL_RESOURCE_ID_SEPARATOR) ||
+        !content_address_1.OPAQUE_TOKEN_PATTERN.test(ref.slug)) {
+        throw new Error(`Invalid logical resource slug "${ref.slug}": expected a non-empty opaque token without "${LOGICAL_RESOURCE_ID_SEPARATOR}".`);
+    }
+    return `${(0, space_1.formatOwnerSpaceKey)(ref.ownerSpaceRef)}${LOGICAL_RESOURCE_ID_SEPARATOR}${ref.slug}`;
+}
+function parseLogicalResourceId(value) {
+    const separator = value.lastIndexOf(LOGICAL_RESOURCE_ID_SEPARATOR);
+    if (separator <= 0 || separator === value.length - 1) {
+        throw new Error(`Invalid logical resource id "${value}": expected "<owner space key>${LOGICAL_RESOURCE_ID_SEPARATOR}<slug>".`);
+    }
+    return {
+        ownerSpaceRef: (0, space_1.parseOwnerSpaceKey)(value.slice(0, separator)),
+        slug: value.slice(separator + 1),
+    };
+}
 //# sourceMappingURL=revision-target.js.map

package/dist/revision-target/lib/revision-target.js.map

@@ -1 +1 @@
-{"version":3,"file":"revision-target.js","sourceRoot":"","sources":["../../../src/revision-target/lib/revision-target.ts"],"names":[],"mappings":";;;AA8FA,0EAIC;AAGD,8CAMC;AA3GD,6BAAwB;AAExB,2DAA8E;AAC9E,uCAIqB;AAErB,MAAM,UAAU,GAAG,OAAC;KACjB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,KAAK,CAAC;KACV,KAAK,CACJ,sCAAoB,EACpB,0EAA0E,CAC3E,CAAC;AAES,QAAA,8BAA8B,GAAG,yBAAyB,CAAC;AAC3D,QAAA,uBAAuB,GAAG,yBAAyB,CAAC;AA6BjE,MAAM,2BAA2B,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,UAAU,EAAE,UAAU;IACtB,WAAW,EAAE,iCAAe;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,oCAAoC,GAAG,OAAC;KAC3C,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAClC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,+BAAuB,CAAC;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,oBAAoB,GAA8B,OAAC;KAC7D,MAAM,CAAC;IACN,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sCAA8B,CAAC;IAC9D,UAAU,EAAE,UAAU;IACtB,QAAQ,EAAE,OAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACrC,2BAA2B;QAC3B,oCAAoC;KACrC,CAAC;CACH,CAAC;KACD,MAAM,EAA+B,CAAC;AAa5B,QAAA,kCAAkC,GAC7C,OAAC;KACE,MAAM,CAAC;IACN,aAAa,EAAE,2BAAmB;IAClC,MAAM,EAAE,4BAAoB;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAGd,SAAgB,+BAA+B,CAC7C,KAAmC;IAEnC,OAAO,GAAG,IAAA,2BAAmB,EAAC,KAAK,CAAC,aAAa,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1F,CAAC;AAGD,SAAgB,iBAAiB,CAAC,MAAsB;IACtD,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;QAC9B,CAAC,CAAC,SAAS,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE;QACtE,CAAC,CAAC,mBAAmB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnD,OAAO,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC;AACnE,CAAC"}
+{"version":3,"file":"revision-target.js","sourceRoot":"","sources":["../../../src/revision-target/lib/revision-target.ts"],"names":[],"mappings":"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"}

package/dist/session-events/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/agent-session.types';
+export * from './lib/session-event-payloads';
+export * from './lib/safe-truncate';
+//# sourceMappingURL=index.d.ts.map

package/dist/session-events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session-events/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC"}

package/dist/session-events/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/agent-session.types"), exports);
+__exportStar(require("./lib/session-event-payloads"), exports);
+__exportStar(require("./lib/safe-truncate"), exports);
+//# sourceMappingURL=index.js.map

package/dist/session-events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session-events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,+DAA6C;AAC7C,sDAAoC"}

package/dist/session-events/lib/agent-session.types.d.ts

@@ -0,0 +1,166 @@
+export declare enum SessionEventType {
+    MessageSent = "message_sent",
+    MessageReceived = "message_received",
+    ToolCallStarted = "tool_call_started",
+    ToolCallCompleted = "tool_call_completed",
+    FileCreated = "file_created",
+    FileEdited = "file_edited",
+    FileDeleted = "file_deleted",
+    GitBranchCreated = "git_branch_created",
+    GitCommitted = "git_committed",
+    GitPushed = "git_pushed",
+    GitMergeConflict = "git_merge_conflict",
+    PrCreated = "pr_created",
+    StatusChanged = "status_changed",
+    AttachmentAdded = "attachment_added",
+    AttachmentRemoved = "attachment_removed",
+    SessionPaused = "session_paused",
+    SessionResumed = "session_resumed",
+    BudgetWarning = "budget_warning",
+    IdleWarning = "idle_warning",
+    UnknownRuntimeEvent = "unknown_runtime_event",
+    QuestionAsked = "question_asked",
+    QuestionAnswered = "question_answered",
+    QuestionRejected = "question_rejected",
+    McpAttached = "mcp_attached",
+    McpDetached = "mcp_detached",
+    SkillAttached = "skill_attached",
+    SkillDetached = "skill_detached",
+    SubagentAttached = "subagent_attached",
+    SubagentDetached = "subagent_detached",
+    SubagentModelChanged = "subagent_model_changed",
+    AgentChanged = "agent_changed",
+    SessionDegraded = "session_degraded",
+    TodoUpdated = "todo_updated",
+    SubagentActivity = "subagent_activity",
+    SessionCompacted = "session_compacted",
+    PermissionAsked = "permission_asked",
+    PermissionReplied = "permission_replied",
+    McpToolsChanged = "mcp_tools_changed",
+    FileWatcherUpdated = "file_watcher_updated",
+    LspDiagnostics = "lsp_diagnostics",
+    Error = "error",
+    OutputSurfaceDetected = "output_surface_detected",
+    OutputSurfaceDeclarationNeeded = "output_surface_declaration_needed",
+    OutputSurfaceDeclarationInvalid = "output_surface_declaration_invalid",
+    OutputSurfaceInstalling = "output_surface_installing",
+    OutputSurfaceInstallFailed = "output_surface_install_failed",
+    OutputSurfaceStarting = "output_surface_starting",
+    OutputSurfaceReady = "output_surface_ready",
+    OutputSurfaceExited = "output_surface_exited",
+    OutputSurfaceRestarted = "output_surface_restarted",
+    ProvisioningPhaseChanged = "provisioning_phase_changed",
+    StepFinished = "step_finished",
+    TextDelta = "text_delta",
+    ReasoningDelta = "reasoning_delta",
+    ToolResult = "tool_result",
+    EnvironmentDriftDetected = "environment_drift_detected",
+    TurnReaped = "turn_reaped",
+    OrgDbResult = "org_db_result"
+}
+export declare const SESSION_EVENT_CONTENT_PREVIEW_LIMITS: {
+    readonly message_sent: 200;
+    readonly message_received: 100;
+};
+export interface SessionEnvironmentDriftEntry {
+    readonly kind: string;
+    readonly severity: 'info' | 'warning';
+    readonly path: string;
+    readonly before?: unknown;
+    readonly after?: unknown;
+    readonly message: string;
+}
+export interface SessionEnvironmentDriftPayload {
+    readonly previousHash: string;
+    readonly currentHash: string;
+    readonly drifts: readonly SessionEnvironmentDriftEntry[];
+}
+export interface StepFinishedPayload {
+    partId: string;
+    messageId: string;
+    reason: string;
+    cost: number;
+    tokens: {
+        input: number;
+        output: number;
+        reasoning: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+}
+export declare const AGENT_SESSION_EVENT_FAMILY: "AGENT_SESSION";
+export declare enum SessionStreamEventType {
+    Delta = "delta",
+    Reasoning = "reasoning",
+    ToolCall = "tool_call",
+    TodoUpdated = "todo_updated",
+    SubagentActivity = "subagent_activity",
+    FileChange = "file_change",
+    StatusChange = "status_change",
+    Activity = "activity",
+    Heartbeat = "heartbeat",
+    Done = "done",
+    Interrupted = "interrupted",
+    HandedOff = "handed_off",
+    QuestionAsked = "question_asked",
+    QuestionReplied = "question_replied",
+    QuestionRejected = "question_rejected",
+    PermissionAsked = "permission_asked",
+    PermissionReplied = "permission_replied",
+    SessionCompacted = "session_compacted",
+    McpToolsChanged = "mcp_tools_changed",
+    FileWatcherUpdated = "file_watcher_updated",
+    LspDiagnostics = "lsp_diagnostics",
+    LspUpdated = "lsp_updated",
+    ProvisioningPhaseChanged = "provisioning_phase_changed",
+    StepFinished = "step_finished",
+    Queued = "queued",
+    Error = "error"
+}
+export declare enum SessionProvisioningPhase {
+    Queued = "queued",
+    WorkerLaunching = "worker_launching",
+    WorkerWaitingReady = "worker_waiting_ready",
+    CredentialsInjecting = "credentials_injecting",
+    WorkspacePreparing = "workspace_preparing",
+    ConfigWriting = "config_writing",
+    ConfigReloading = "config_reloading",
+    Ready = "ready",
+    Failed = "failed"
+}
+export declare const PROVISIONING_PHASE_ORDER: readonly SessionProvisioningPhase[];
+export declare const PROVISIONING_PHASE_LABELS: Record<SessionProvisioningPhase, string>;
+export interface SessionTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+}
+export declare enum SessionMutatingAction {
+    SendMessage = "send_message",
+    Interrupt = "interrupt",
+    Pause = "pause",
+    Resume = "resume",
+    Terminate = "terminate",
+    Promote = "promote",
+    GitCommit = "git_commit",
+    GitPush = "git_push",
+    GitBranch = "git_branch",
+    AddAttachment = "add_attachment",
+    RemoveAttachment = "remove_attachment"
+}
+export interface QuestionOption {
+    label: string;
+    description: string;
+}
+export interface QuestionInfo {
+    header: string;
+    question: string;
+    options: QuestionOption[];
+    multiple?: boolean;
+}
+export interface QuestionRequest {
+    requestId: string;
+    sessionId: string;
+    questions: QuestionInfo[];
+}
+export type QuestionAnswer = string[];
+//# sourceMappingURL=agent-session.types.d.ts.map

package/dist/session-events/lib/agent-session.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.types.d.ts","sourceRoot":"","sources":["../../../src/session-events/lib/agent-session.types.ts"],"names":[],"mappings":"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"}

package/dist/session-events/lib/agent-session.types.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionMutatingAction = exports.PROVISIONING_PHASE_LABELS = exports.PROVISIONING_PHASE_ORDER = exports.SessionProvisioningPhase = exports.SessionStreamEventType = exports.AGENT_SESSION_EVENT_FAMILY = exports.SESSION_EVENT_CONTENT_PREVIEW_LIMITS = exports.SessionEventType = void 0;
+var SessionEventType;
+(function (SessionEventType) {
+    SessionEventType["MessageSent"] = "message_sent";
+    SessionEventType["MessageReceived"] = "message_received";
+    SessionEventType["ToolCallStarted"] = "tool_call_started";
+    SessionEventType["ToolCallCompleted"] = "tool_call_completed";
+    SessionEventType["FileCreated"] = "file_created";
+    SessionEventType["FileEdited"] = "file_edited";
+    SessionEventType["FileDeleted"] = "file_deleted";
+    SessionEventType["GitBranchCreated"] = "git_branch_created";
+    SessionEventType["GitCommitted"] = "git_committed";
+    SessionEventType["GitPushed"] = "git_pushed";
+    SessionEventType["GitMergeConflict"] = "git_merge_conflict";
+    SessionEventType["PrCreated"] = "pr_created";
+    SessionEventType["StatusChanged"] = "status_changed";
+    SessionEventType["AttachmentAdded"] = "attachment_added";
+    SessionEventType["AttachmentRemoved"] = "attachment_removed";
+    SessionEventType["SessionPaused"] = "session_paused";
+    SessionEventType["SessionResumed"] = "session_resumed";
+    SessionEventType["BudgetWarning"] = "budget_warning";
+    SessionEventType["IdleWarning"] = "idle_warning";
+    SessionEventType["UnknownRuntimeEvent"] = "unknown_runtime_event";
+    SessionEventType["QuestionAsked"] = "question_asked";
+    SessionEventType["QuestionAnswered"] = "question_answered";
+    SessionEventType["QuestionRejected"] = "question_rejected";
+    SessionEventType["McpAttached"] = "mcp_attached";
+    SessionEventType["McpDetached"] = "mcp_detached";
+    SessionEventType["SkillAttached"] = "skill_attached";
+    SessionEventType["SkillDetached"] = "skill_detached";
+    SessionEventType["SubagentAttached"] = "subagent_attached";
+    SessionEventType["SubagentDetached"] = "subagent_detached";
+    SessionEventType["SubagentModelChanged"] = "subagent_model_changed";
+    SessionEventType["AgentChanged"] = "agent_changed";
+    SessionEventType["SessionDegraded"] = "session_degraded";
+    SessionEventType["TodoUpdated"] = "todo_updated";
+    SessionEventType["SubagentActivity"] = "subagent_activity";
+    SessionEventType["SessionCompacted"] = "session_compacted";
+    SessionEventType["PermissionAsked"] = "permission_asked";
+    SessionEventType["PermissionReplied"] = "permission_replied";
+    SessionEventType["McpToolsChanged"] = "mcp_tools_changed";
+    SessionEventType["FileWatcherUpdated"] = "file_watcher_updated";
+    SessionEventType["LspDiagnostics"] = "lsp_diagnostics";
+    SessionEventType["Error"] = "error";
+    SessionEventType["OutputSurfaceDetected"] = "output_surface_detected";
+    SessionEventType["OutputSurfaceDeclarationNeeded"] = "output_surface_declaration_needed";
+    SessionEventType["OutputSurfaceDeclarationInvalid"] = "output_surface_declaration_invalid";
+    SessionEventType["OutputSurfaceInstalling"] = "output_surface_installing";
+    SessionEventType["OutputSurfaceInstallFailed"] = "output_surface_install_failed";
+    SessionEventType["OutputSurfaceStarting"] = "output_surface_starting";
+    SessionEventType["OutputSurfaceReady"] = "output_surface_ready";
+    SessionEventType["OutputSurfaceExited"] = "output_surface_exited";
+    SessionEventType["OutputSurfaceRestarted"] = "output_surface_restarted";
+    SessionEventType["ProvisioningPhaseChanged"] = "provisioning_phase_changed";
+    SessionEventType["StepFinished"] = "step_finished";
+    SessionEventType["TextDelta"] = "text_delta";
+    SessionEventType["ReasoningDelta"] = "reasoning_delta";
+    SessionEventType["ToolResult"] = "tool_result";
+    SessionEventType["EnvironmentDriftDetected"] = "environment_drift_detected";
+    SessionEventType["TurnReaped"] = "turn_reaped";
+    SessionEventType["OrgDbResult"] = "org_db_result";
+})(SessionEventType || (exports.SessionEventType = SessionEventType = {}));
+exports.SESSION_EVENT_CONTENT_PREVIEW_LIMITS = {
+    [SessionEventType.MessageSent]: 200,
+    [SessionEventType.MessageReceived]: 100,
+};
+exports.AGENT_SESSION_EVENT_FAMILY = 'AGENT_SESSION';
+var SessionStreamEventType;
+(function (SessionStreamEventType) {
+    SessionStreamEventType["Delta"] = "delta";
+    SessionStreamEventType["Reasoning"] = "reasoning";
+    SessionStreamEventType["ToolCall"] = "tool_call";
+    SessionStreamEventType["TodoUpdated"] = "todo_updated";
+    SessionStreamEventType["SubagentActivity"] = "subagent_activity";
+    SessionStreamEventType["FileChange"] = "file_change";
+    SessionStreamEventType["StatusChange"] = "status_change";
+    SessionStreamEventType["Activity"] = "activity";
+    SessionStreamEventType["Heartbeat"] = "heartbeat";
+    SessionStreamEventType["Done"] = "done";
+    SessionStreamEventType["Interrupted"] = "interrupted";
+    SessionStreamEventType["HandedOff"] = "handed_off";
+    SessionStreamEventType["QuestionAsked"] = "question_asked";
+    SessionStreamEventType["QuestionReplied"] = "question_replied";
+    SessionStreamEventType["QuestionRejected"] = "question_rejected";
+    SessionStreamEventType["PermissionAsked"] = "permission_asked";
+    SessionStreamEventType["PermissionReplied"] = "permission_replied";
+    SessionStreamEventType["SessionCompacted"] = "session_compacted";
+    SessionStreamEventType["McpToolsChanged"] = "mcp_tools_changed";
+    SessionStreamEventType["FileWatcherUpdated"] = "file_watcher_updated";
+    SessionStreamEventType["LspDiagnostics"] = "lsp_diagnostics";
+    SessionStreamEventType["LspUpdated"] = "lsp_updated";
+    SessionStreamEventType["ProvisioningPhaseChanged"] = "provisioning_phase_changed";
+    SessionStreamEventType["StepFinished"] = "step_finished";
+    SessionStreamEventType["Queued"] = "queued";
+    SessionStreamEventType["Error"] = "error";
+})(SessionStreamEventType || (exports.SessionStreamEventType = SessionStreamEventType = {}));
+var SessionProvisioningPhase;
+(function (SessionProvisioningPhase) {
+    SessionProvisioningPhase["Queued"] = "queued";
+    SessionProvisioningPhase["WorkerLaunching"] = "worker_launching";
+    SessionProvisioningPhase["WorkerWaitingReady"] = "worker_waiting_ready";
+    SessionProvisioningPhase["CredentialsInjecting"] = "credentials_injecting";
+    SessionProvisioningPhase["WorkspacePreparing"] = "workspace_preparing";
+    SessionProvisioningPhase["ConfigWriting"] = "config_writing";
+    SessionProvisioningPhase["ConfigReloading"] = "config_reloading";
+    SessionProvisioningPhase["Ready"] = "ready";
+    SessionProvisioningPhase["Failed"] = "failed";
+})(SessionProvisioningPhase || (exports.SessionProvisioningPhase = SessionProvisioningPhase = {}));
+exports.PROVISIONING_PHASE_ORDER = [
+    SessionProvisioningPhase.Queued,
+    SessionProvisioningPhase.WorkerLaunching,
+    SessionProvisioningPhase.WorkerWaitingReady,
+    SessionProvisioningPhase.CredentialsInjecting,
+    SessionProvisioningPhase.ConfigWriting,
+    SessionProvisioningPhase.ConfigReloading,
+    SessionProvisioningPhase.WorkspacePreparing,
+    SessionProvisioningPhase.Ready,
+];
+exports.PROVISIONING_PHASE_LABELS = {
+    [SessionProvisioningPhase.Queued]: 'Queued in worker pool',
+    [SessionProvisioningPhase.WorkerLaunching]: 'Launching worker container',
+    [SessionProvisioningPhase.WorkerWaitingReady]: 'Waiting for worker boot',
+    [SessionProvisioningPhase.CredentialsInjecting]: 'Injecting credentials',
+    [SessionProvisioningPhase.WorkspacePreparing]: 'Preparing workspace',
+    [SessionProvisioningPhase.ConfigWriting]: 'Writing workspace config',
+    [SessionProvisioningPhase.ConfigReloading]: 'Reloading worker config',
+    [SessionProvisioningPhase.Ready]: 'Ready',
+    [SessionProvisioningPhase.Failed]: 'Failed',
+};
+var SessionMutatingAction;
+(function (SessionMutatingAction) {
+    SessionMutatingAction["SendMessage"] = "send_message";
+    SessionMutatingAction["Interrupt"] = "interrupt";
+    SessionMutatingAction["Pause"] = "pause";
+    SessionMutatingAction["Resume"] = "resume";
+    SessionMutatingAction["Terminate"] = "terminate";
+    SessionMutatingAction["Promote"] = "promote";
+    SessionMutatingAction["GitCommit"] = "git_commit";
+    SessionMutatingAction["GitPush"] = "git_push";
+    SessionMutatingAction["GitBranch"] = "git_branch";
+    SessionMutatingAction["AddAttachment"] = "add_attachment";
+    SessionMutatingAction["RemoveAttachment"] = "remove_attachment";
+})(SessionMutatingAction || (exports.SessionMutatingAction = SessionMutatingAction = {}));
+//# sourceMappingURL=agent-session.types.js.map

package/dist/session-events/lib/agent-session.types.js.map

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

package/dist/session-events/lib/safe-truncate.d.ts

@@ -0,0 +1,2 @@
+export declare function safeTruncate(value: string, maxCodeUnits: number): string;
+//# sourceMappingURL=safe-truncate.d.ts.map

package/dist/session-events/lib/safe-truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-truncate.d.ts","sourceRoot":"","sources":["../../../src/session-events/lib/safe-truncate.ts"],"names":[],"mappings":"AAiBA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAUxE"}

package/dist/session-events/lib/safe-truncate.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeTruncate = safeTruncate;
+function safeTruncate(value, maxCodeUnits) {
+    if (maxCodeUnits <= 0) {
+        return '';
+    }
+    if (value.length <= maxCodeUnits) {
+        return value;
+    }
+    const last = value.charCodeAt(maxCodeUnits - 1);
+    const truncatedLen = last >= 0xd800 && last <= 0xdbff ? maxCodeUnits - 1 : maxCodeUnits;
+    return value.slice(0, truncatedLen);
+}
+//# sourceMappingURL=safe-truncate.js.map

package/dist/session-events/lib/safe-truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-truncate.js","sourceRoot":"","sources":["../../../src/session-events/lib/safe-truncate.ts"],"names":[],"mappings":";;AAiBA,oCAUC;AAVD,SAAgB,YAAY,CAAC,KAAa,EAAE,YAAoB;IAC9D,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACxF,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AACtC,CAAC"}

package/dist/session-events/lib/session-event-payloads/actor.d.ts

@@ -0,0 +1,12 @@
+export declare enum SessionEventActorSubjectKind {
+    OrgUser = "org_user",
+    ExternalContact = "external_contact"
+}
+export type SessionEventActorSubjectKindValue = `${SessionEventActorSubjectKind}`;
+export type SessionEventActor = {
+    subjectKind: SessionEventActorSubjectKindValue;
+    subjectRef: string;
+    displayName: string;
+    avatarUrl?: string;
+};
+//# sourceMappingURL=actor.d.ts.map

package/dist/session-events/lib/session-event-payloads/actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/actor.ts"],"names":[],"mappings":"AAqBA,oBAAY,4BAA4B;IAEtC,OAAO,aAAa;IAcpB,eAAe,qBAAqB;CACrC;AAaD,MAAM,MAAM,iCAAiC,GAC3C,GAAG,4BAA4B,EAAE,CAAC;AAWpC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,iCAAiC,CAAC;IAM/C,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/session-events/lib/session-event-payloads/actor.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionEventActorSubjectKind = void 0;
+var SessionEventActorSubjectKind;
+(function (SessionEventActorSubjectKind) {
+    SessionEventActorSubjectKind["OrgUser"] = "org_user";
+    SessionEventActorSubjectKind["ExternalContact"] = "external_contact";
+})(SessionEventActorSubjectKind || (exports.SessionEventActorSubjectKind = SessionEventActorSubjectKind = {}));
+//# sourceMappingURL=actor.js.map

package/dist/session-events/lib/session-event-payloads/actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/actor.ts"],"names":[],"mappings":";;;AAqBA,IAAY,4BAiBX;AAjBD,WAAY,4BAA4B;IAEtC,oDAAoB,CAAA;IAcpB,oEAAoC,CAAA;AACtC,CAAC,EAjBW,4BAA4B,4CAA5B,4BAA4B,QAiBvC"}

package/dist/session-events/lib/session-event-payloads/assistant-message-metadata.d.ts

@@ -0,0 +1,25 @@
+import type { ChatWidgetEnvelope } from '../../../widget';
+import type { SessionTurnId } from './payloads';
+import type { SessionToolCallStatus } from './tool-call-enums';
+export type SessionPersistedToolCall = {
+    toolCallId?: string;
+    toolName: string;
+    status: SessionToolCallStatus;
+    title: string;
+    detail?: string;
+};
+export type SessionAssistantMessageMetadata = {
+    turnId: SessionTurnId;
+    widgets?: ChatWidgetEnvelope[];
+    toolCalls?: SessionPersistedToolCall[];
+    reasoning?: string;
+    railNotRecorded?: true;
+};
+export declare function buildAssistantMessageMetadata(args: {
+    turnId: SessionTurnId;
+    widgets?: readonly ChatWidgetEnvelope[];
+    toolCalls?: readonly SessionPersistedToolCall[];
+    reasoning?: string;
+    railNotRecorded?: true;
+}): SessionAssistantMessageMetadata;
+//# sourceMappingURL=assistant-message-metadata.d.ts.map

package/dist/session-events/lib/session-event-payloads/assistant-message-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-message-metadata.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/assistant-message-metadata.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAO/D,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAiBF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAwBnB,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,CAAC;AAUF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,GAAG,+BAA+B,CAiClC"}

package/dist/session-events/lib/session-event-payloads/assistant-message-metadata.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAssistantMessageMetadata = buildAssistantMessageMetadata;
+function buildAssistantMessageMetadata(args) {
+    if (args.turnId.length === 0) {
+        throw new TypeError('Assistant message metadata field "turnId" must be a non-empty string.');
+    }
+    const reasoning = args.reasoning?.trim() ?? '';
+    const hasRailContent = (args.widgets?.length ?? 0) > 0 ||
+        (args.toolCalls?.length ?? 0) > 0 ||
+        reasoning.length > 0;
+    if (args.railNotRecorded === true && hasRailContent) {
+        throw new TypeError('Assistant message metadata cannot be marked railNotRecorded while ' +
+            'carrying rail content. A producer either observed the rail or did not.');
+    }
+    return {
+        turnId: args.turnId,
+        ...(args.widgets !== undefined &&
+            args.widgets.length > 0 && { widgets: [...args.widgets] }),
+        ...(args.toolCalls !== undefined &&
+            args.toolCalls.length > 0 && { toolCalls: [...args.toolCalls] }),
+        ...(reasoning.length > 0 && { reasoning }),
+        ...(args.railNotRecorded === true && { railNotRecorded: true }),
+    };
+}
+//# sourceMappingURL=assistant-message-metadata.js.map

package/dist/session-events/lib/session-event-payloads/assistant-message-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-message-metadata.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/assistant-message-metadata.ts"],"names":[],"mappings":";;AAuFA,sEA2CC;AA3CD,SAAgB,6BAA6B,CAAC,IAU7C;IACC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CACjB,uEAAuE,CACxE,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,cAAc,GAClB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAC/B,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACjC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAMvB,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,cAAc,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CACjB,oEAAoE;YAClE,wEAAwE,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS;YAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS;YAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAG1C,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,EAAE,eAAe,EAAE,IAAa,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.d.ts

@@ -0,0 +1,11 @@
+export declare const SESSION_DELTA_LEDGER_FLUSH_CHARS = 240;
+export declare class SessionDeltaLedgerBuffer {
+    private readonly flushChars;
+    private buffered;
+    private firstChunkEmitted;
+    constructor(flushChars?: number);
+    get hasPending(): boolean;
+    push(text: string): string | null;
+    flush(): string | null;
+}
+//# sourceMappingURL=delta-ledger-policy.d.ts.map

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-ledger-policy.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/delta-ledger-policy.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAqBpD,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,iBAAiB,CAAS;gBAGf,UAAU,GAAE,MAAyC;IAUxE,IAAI,UAAU,IAAI,OAAO,CAExB;IASD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAoBjC,KAAK,IAAI,MAAM,GAAG,IAAI;CASvB"}

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionDeltaLedgerBuffer = exports.SESSION_DELTA_LEDGER_FLUSH_CHARS = void 0;
+exports.SESSION_DELTA_LEDGER_FLUSH_CHARS = 240;
+class SessionDeltaLedgerBuffer {
+    flushChars;
+    buffered = '';
+    firstChunkEmitted = false;
+    constructor(flushChars = exports.SESSION_DELTA_LEDGER_FLUSH_CHARS) {
+        this.flushChars = flushChars;
+        if (!Number.isInteger(flushChars) || flushChars <= 0) {
+            throw new RangeError(`SessionDeltaLedgerBuffer flushChars must be a positive integer, received ${String(flushChars)}.`);
+        }
+    }
+    get hasPending() {
+        return this.buffered.length > 0;
+    }
+    push(text) {
+        if (text.length === 0) {
+            return null;
+        }
+        this.buffered += text;
+        const shouldFlush = !this.firstChunkEmitted || this.buffered.length >= this.flushChars;
+        if (!shouldFlush) {
+            return null;
+        }
+        const chunk = this.buffered;
+        this.buffered = '';
+        this.firstChunkEmitted = true;
+        return chunk;
+    }
+    flush() {
+        if (this.buffered.length === 0) {
+            return null;
+        }
+        const chunk = this.buffered;
+        this.buffered = '';
+        this.firstChunkEmitted = true;
+        return chunk;
+    }
+}
+exports.SessionDeltaLedgerBuffer = SessionDeltaLedgerBuffer;
+//# sourceMappingURL=delta-ledger-policy.js.map

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-ledger-policy.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/delta-ledger-policy.ts"],"names":[],"mappings":";;;AA6Ba,QAAA,gCAAgC,GAAG,GAAG,CAAC;AAqBpD,MAAa,wBAAwB;IAKhB;IAJX,QAAQ,GAAG,EAAE,CAAC;IACd,iBAAiB,GAAG,KAAK,CAAC;IAElC,YACmB,aAAqB,wCAAgC;QAArD,eAAU,GAAV,UAAU,CAA2C;QAEtE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAClB,4EAA4E,MAAM,CAAC,UAAU,CAAC,GAAG,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAGD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IASD,IAAI,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;QACtB,MAAM,WAAW,GACf,CAAC,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC;QACrE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAMD,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAvDD,4DAuDC"}