@happier-dev/stack 0.2.1-preview.1775586714.26562 → 0.2.11

package/node_modules/@happier-dev/protocol/dist/actions/operations/actionOperationV1.js

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import { SessionForkStrategySchema } from '../../sessionFork.js';
+const ACTION_OPERATION_ID_MAX_LENGTH = 2_000;
+const ACTION_OPERATION_PHASE_MAX_LENGTH = 200;
+const ACTION_OPERATION_LABEL_MAX_LENGTH = 1_000;
+const ACTION_OPERATION_TITLE_MAX_LENGTH = 10_000;
+const ACTION_OPERATION_ERROR_CODE_MAX_LENGTH = 200;
+const ACTION_OPERATION_ERROR_MAX_LENGTH = 10_000;
+export const ACTION_OPERATION_RPC_METHODS_V1 = Object.freeze({
+    list: 'actionOperation.list.v1',
+    get: 'actionOperation.get.v1',
+    cancel: 'actionOperation.cancel.v1',
+});
+const ActionOperationIdentifierSchema = z.string().trim().min(1).max(ACTION_OPERATION_ID_MAX_LENGTH);
+const ActionOperationTimestampSchema = z.number().finite().int().nonnegative();
+export const ActionOperationStateV1Schema = z.enum([
+    'accepted',
+    'running',
+    'succeeded',
+    'failed',
+    'cancelled',
+]);
+const ActionOperationProgressLabelSchema = z.string().trim().min(1).max(ACTION_OPERATION_LABEL_MAX_LENGTH);
+export const ActionOperationProgressV1Schema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('indeterminate'),
+        label: ActionOperationProgressLabelSchema.optional(),
+    }).strict(),
+    z.object({
+        kind: z.literal('phase'),
+        phase: z.string().trim().min(1).max(ACTION_OPERATION_PHASE_MAX_LENGTH),
+        label: ActionOperationProgressLabelSchema,
+    }).strict(),
+    z.object({
+        kind: z.literal('determinate'),
+        current: z.number().finite().nonnegative(),
+        total: z.number().finite().positive(),
+        label: ActionOperationProgressLabelSchema.optional(),
+    }).strict().refine((progress) => progress.current <= progress.total, {
+        message: 'current must not exceed total',
+        path: ['current'],
+    }),
+]);
+/** Redacted Action executor failure projection safe for public operation UI. */
+export const ActionOperationFailureV1Schema = z.object({
+    errorCode: z.string().trim().min(1).max(ACTION_OPERATION_ERROR_CODE_MAX_LENGTH),
+    error: z.string().trim().min(1).max(ACTION_OPERATION_ERROR_MAX_LENGTH),
+}).strict();
+export const ActionOperationScopeV1Schema = z.object({
+    accountId: ActionOperationIdentifierSchema,
+    machineId: ActionOperationIdentifierSchema,
+    sessionId: ActionOperationIdentifierSchema.optional(),
+}).strict();
+export const ActionOperationDomainRefV1Schema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('forkRequest'),
+        id: ActionOperationIdentifierSchema,
+        strategy: SessionForkStrategySchema.optional(),
+    }).strict(),
+    z.object({ kind: z.literal('spawnAttempt'), id: ActionOperationIdentifierSchema }).strict(),
+    z.object({
+        kind: z.literal('handoff'),
+        id: ActionOperationIdentifierSchema,
+        targetMachineId: ActionOperationIdentifierSchema.optional(),
+    }).strict(),
+]);
+const ActionOperationSnapshotV1BaseSchema = z.object({
+    version: z.literal(1),
+    operationId: ActionOperationIdentifierSchema,
+    requestId: ActionOperationIdentifierSchema.optional(),
+    revision: z.number().finite().int().min(1),
+    actionId: ActionOperationIdentifierSchema,
+    state: ActionOperationStateV1Schema,
+    scope: ActionOperationScopeV1Schema,
+    title: z.string().trim().min(1).max(ACTION_OPERATION_TITLE_MAX_LENGTH),
+    createdAt: ActionOperationTimestampSchema,
+    startedAt: ActionOperationTimestampSchema.optional(),
+    settledAt: ActionOperationTimestampSchema.optional(),
+    progress: ActionOperationProgressV1Schema.optional(),
+    result: z.unknown().optional(),
+    error: ActionOperationFailureV1Schema.optional(),
+    domainRef: ActionOperationDomainRefV1Schema.optional(),
+    cancellation: z.enum(['unsupported', 'supported']),
+}).strict();
+export const ActionOperationSnapshotV1Schema = ActionOperationSnapshotV1BaseSchema.superRefine((snapshot, ctx) => {
+    const hasResult = Object.prototype.hasOwnProperty.call(snapshot, 'result');
+    const hasError = Object.prototype.hasOwnProperty.call(snapshot, 'error');
+    if (snapshot.startedAt !== undefined && snapshot.startedAt < snapshot.createdAt) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['startedAt'],
+            message: 'startedAt must not precede createdAt',
+        });
+    }
+    if (snapshot.settledAt !== undefined) {
+        if (snapshot.startedAt === undefined || snapshot.settledAt < snapshot.startedAt) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['settledAt'],
+                message: 'settledAt requires and must not precede startedAt',
+            });
+        }
+    }
+    if (snapshot.state === 'accepted') {
+        if (snapshot.startedAt !== undefined) {
+            ctx.addIssue({ code: 'custom', path: ['startedAt'], message: 'accepted operations have not started' });
+        }
+        if (snapshot.settledAt !== undefined || hasResult || hasError) {
+            ctx.addIssue({ code: 'custom', path: ['state'], message: 'accepted operations cannot have terminal fields' });
+        }
+        return;
+    }
+    if (snapshot.startedAt === undefined) {
+        ctx.addIssue({ code: 'custom', path: ['startedAt'], message: 'startedAt is required after acceptance' });
+    }
+    if (snapshot.state === 'running') {
+        if (snapshot.settledAt !== undefined || hasResult || hasError) {
+            ctx.addIssue({ code: 'custom', path: ['state'], message: 'running operations cannot have terminal fields' });
+        }
+        return;
+    }
+    if (snapshot.settledAt === undefined) {
+        ctx.addIssue({ code: 'custom', path: ['settledAt'], message: 'terminal operations require settledAt' });
+    }
+    if (snapshot.state === 'succeeded') {
+        if (hasError) {
+            ctx.addIssue({ code: 'custom', path: ['error'], message: 'succeeded operations cannot have an error' });
+        }
+        return;
+    }
+    if (snapshot.state === 'failed') {
+        if (!hasError) {
+            ctx.addIssue({ code: 'custom', path: ['error'], message: 'failed operations require an error' });
+        }
+        if (hasResult) {
+            ctx.addIssue({ code: 'custom', path: ['result'], message: 'failed operations cannot have a result' });
+        }
+        return;
+    }
+    if (hasResult || hasError) {
+        ctx.addIssue({ code: 'custom', path: ['state'], message: 'cancelled operations cannot have result or error fields' });
+    }
+});
+export const ActionOperationRevisionEphemeralV1Schema = z.object({
+    type: z.literal('action-operation-updated'),
+    machineId: ActionOperationIdentifierSchema,
+    content: z.object({
+        t: z.literal('encrypted'),
+        c: z.string().trim().min(1),
+    }).strict(),
+}).strict();
+export const ActionOperationListV1RequestSchema = z.object({
+    states: z.array(ActionOperationStateV1Schema).max(ActionOperationStateV1Schema.options.length).optional(),
+    sessionId: ActionOperationIdentifierSchema.optional(),
+    cursor: ActionOperationIdentifierSchema.optional(),
+}).strict().superRefine((request, ctx) => {
+    if (request.states && new Set(request.states).size !== request.states.length) {
+        ctx.addIssue({ code: 'custom', path: ['states'], message: 'states must not contain duplicates' });
+    }
+});
+export const ActionOperationListV1ResponseSchema = z.object({
+    items: z.array(ActionOperationSnapshotV1Schema),
+    nextCursor: ActionOperationIdentifierSchema.nullable(),
+}).strict();
+export const ActionOperationGetV1RequestSchema = z.object({
+    operationId: ActionOperationIdentifierSchema,
+}).strict();
+const ActionOperationNotFoundV1Schema = z.object({ kind: z.literal('not_found') }).strict();
+export const ActionOperationGetV1ResponseSchema = z.union([
+    z.object({ kind: z.literal('found'), operation: ActionOperationSnapshotV1Schema }).strict(),
+    ActionOperationNotFoundV1Schema,
+]);
+export const ActionOperationCancelV1RequestSchema = ActionOperationGetV1RequestSchema;
+export const ActionOperationCancelV1ResponseSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('unsupported') }).strict(),
+    z.object({ kind: z.literal('requested') }).strict(),
+    z.object({ kind: z.literal('already_settled') }).strict(),
+    ActionOperationNotFoundV1Schema,
+]);
+//# sourceMappingURL=actionOperationV1.js.map

package/node_modules/@happier-dev/protocol/dist/actions/operations/actionOperationV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionOperationV1.js","sourceRoot":"","sources":["../../../src/actions/operations/actionOperationV1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAC7C,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAC9C,MAAM,iCAAiC,GAAG,KAAK,CAAC;AAChD,MAAM,iCAAiC,GAAG,MAAM,CAAC;AACjD,MAAM,sCAAsC,GAAG,GAAG,CAAC;AACnD,MAAM,iCAAiC,GAAG,MAAM,CAAC;AAEjD,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3D,IAAI,EAAE,yBAAyB;IAC/B,GAAG,EAAE,wBAAwB;IAC7B,MAAM,EAAE,2BAA2B;CAC3B,CAAC,CAAC;AAEZ,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AACrG,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAE/E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,IAAI,CAAC;IACjD,UAAU;IACV,SAAS;IACT,WAAW;IACX,QAAQ;IACR,WAAW;CACZ,CAAC,CAAC;AAGH,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAE3G,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC1E,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QAChC,KAAK,EAAE,kCAAkC,CAAC,QAAQ,EAAE;KACrD,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC;QACtE,KAAK,EAAE,kCAAkC;KAC1C,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;QAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,KAAK,EAAE,kCAAkC,CAAC,QAAQ,EAAE;KACrD,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE;QACnE,OAAO,EAAE,+BAA+B;QACxC,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB,CAAC;CACH,CAAC,CAAC;AAGH,gFAAgF;AAChF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,sCAAsC,CAAC;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC;CACvE,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,+BAA+B;IAC1C,SAAS,EAAE,+BAA+B;IAC1C,SAAS,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3E,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAC9B,EAAE,EAAE,+BAA+B;QACnC,QAAQ,EAAE,yBAAyB,CAAC,QAAQ,EAAE;KAC/C,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,+BAA+B,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3F,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC1B,EAAE,EAAE,+BAA+B;QACnC,eAAe,EAAE,+BAA+B,CAAC,QAAQ,EAAE;KAC5D,CAAC,CAAC,MAAM,EAAE;CACZ,CAAC,CAAC;AAGH,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,WAAW,EAAE,+BAA+B;IAC5C,SAAS,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,QAAQ,EAAE,+BAA+B;IACzC,KAAK,EAAE,4BAA4B;IACnC,KAAK,EAAE,4BAA4B;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC;IACtE,SAAS,EAAE,8BAA8B;IACzC,SAAS,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IACpD,SAAS,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IACpD,QAAQ,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IACpD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IACtD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;CACnD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,+BAA+B,GAAG,mCAAmC,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;IAC/G,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzE,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QAChF,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;YAChF,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,WAAW,CAAC;gBACnB,OAAO,EAAE,mDAAmD;aAC7D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAClC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACrC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC,CAAC;QACzG,CAAC;QACD,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;YAC9D,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC,CAAC;QAChH,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;YAC9D,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACnC,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC,CAAC;QAC1G,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC,CAAC;QACxG,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC,CAAC;IACxH,CAAC;AACH,CAAC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/D,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC;IAC3C,SAAS,EAAE,+BAA+B;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QACzB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC5B,CAAC,CAAC,MAAM,EAAE;CACZ,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,GAAG,CAAC,4BAA4B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACzG,SAAS,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IACrD,MAAM,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;IACvC,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7E,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;IACpG,CAAC;AACH,CAAC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IAC/C,UAAU,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,WAAW,EAAE,+BAA+B;CAC7C,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE5F,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC;IACxD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,+BAA+B,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3F,+BAA+B;CAChC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oCAAoC,GAAG,iCAAiC,CAAC;AAGtF,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAChF,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACrD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACnD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACzD,+BAA+B;CAChC,CAAC,CAAC"}

package/node_modules/@happier-dev/protocol/dist/actions/operations/index.d.ts

@@ -0,0 +1,3 @@
+export { ActionOperationDeclarationV1Schema, type ActionOperationDeclarationV1, } from './actionOperationDeclarationV1.js';
+export { ACTION_OPERATION_RPC_METHODS_V1, ActionOperationCancelV1RequestSchema, ActionOperationCancelV1ResponseSchema, ActionOperationDomainRefV1Schema, ActionOperationFailureV1Schema, ActionOperationGetV1RequestSchema, ActionOperationGetV1ResponseSchema, ActionOperationListV1RequestSchema, ActionOperationListV1ResponseSchema, ActionOperationProgressV1Schema, ActionOperationRevisionEphemeralV1Schema, ActionOperationScopeV1Schema, ActionOperationSnapshotV1Schema, ActionOperationStateV1Schema, type ActionOperationCancelV1Request, type ActionOperationCancelV1Response, type ActionOperationDomainRefV1, type ActionOperationFailureV1, type ActionOperationGetV1Request, type ActionOperationGetV1Response, type ActionOperationListV1Request, type ActionOperationListV1Response, type ActionOperationProgressV1, type ActionOperationRevisionEphemeralV1, type ActionOperationScopeV1, type ActionOperationSnapshotV1, type ActionOperationStateV1, } from './actionOperationV1.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@happier-dev/protocol/dist/actions/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,KAAK,4BAA4B,GAClC,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,+BAA+B,EAC/B,oCAAoC,EACpC,qCAAqC,EACrC,gCAAgC,EAChC,8BAA8B,EAC9B,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EAClC,mCAAmC,EACnC,+BAA+B,EAC/B,wCAAwC,EACxC,4BAA4B,EAC5B,+BAA+B,EAC/B,4BAA4B,EAC5B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC"}

package/node_modules/@happier-dev/protocol/dist/actions/operations/index.js

@@ -0,0 +1,3 @@
+export { ActionOperationDeclarationV1Schema, } from './actionOperationDeclarationV1.js';
+export { ACTION_OPERATION_RPC_METHODS_V1, ActionOperationCancelV1RequestSchema, ActionOperationCancelV1ResponseSchema, ActionOperationDomainRefV1Schema, ActionOperationFailureV1Schema, ActionOperationGetV1RequestSchema, ActionOperationGetV1ResponseSchema, ActionOperationListV1RequestSchema, ActionOperationListV1ResponseSchema, ActionOperationProgressV1Schema, ActionOperationRevisionEphemeralV1Schema, ActionOperationScopeV1Schema, ActionOperationSnapshotV1Schema, ActionOperationStateV1Schema, } from './actionOperationV1.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@happier-dev/protocol/dist/actions/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,GAEnC,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,+BAA+B,EAC/B,oCAAoC,EACpC,qCAAqC,EACrC,gCAAgC,EAChC,8BAA8B,EAC9B,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EAClC,mCAAmC,EACnC,+BAA+B,EAC/B,wCAAwC,EACxC,4BAA4B,EAC5B,+BAA+B,EAC/B,4BAA4B,GAc7B,MAAM,wBAAwB,CAAC"}

package/node_modules/@happier-dev/protocol/dist/actions/permissionPrivilege.d.ts

@@ -0,0 +1,37 @@
+import { type SessionPermissionMode } from '../sessionMetadata/sessionPermissionModes.js';
+export type PermissionPrivilegeOrdinal = 0 | 1 | 2 | 3;
+export type PermissionEscalationDecision = Readonly<{
+    ok: true;
+    requestedMode: string;
+    normalizedMode: SessionPermissionMode;
+    requestedOrdinal: PermissionPrivilegeOrdinal;
+    callerMode: string;
+    callerOrdinal: PermissionPrivilegeOrdinal;
+}> | Readonly<{
+    ok: false;
+    reason: 'permission_escalation_denied';
+    requestedMode: string;
+    normalizedMode: SessionPermissionMode;
+    requestedOrdinal: PermissionPrivilegeOrdinal;
+    callerMode: string;
+    callerOrdinal: PermissionPrivilegeOrdinal;
+}> | Readonly<{
+    ok: false;
+    reason: 'invalid_parameters';
+    requestedMode: string;
+    requestedOrdinal: null;
+    callerMode: string;
+    callerOrdinal: PermissionPrivilegeOrdinal;
+}>;
+export declare function resolvePermissionPrivilegeOrdinal(rawMode: unknown): PermissionPrivilegeOrdinal | null;
+export declare function assertNonEscalatingPermissionMode(params: Readonly<{
+    requestedMode: unknown;
+    callerMode: unknown;
+    supportedModes?: readonly string[];
+}>): PermissionEscalationDecision;
+export declare function resolveNearestPermissionModeAtOrBelow(params: Readonly<{
+    requestedMode: unknown;
+    callerMode: unknown;
+    supportedModes?: readonly string[];
+}>): PermissionEscalationDecision;
+//# sourceMappingURL=permissionPrivilege.d.ts.map

package/node_modules/@happier-dev/protocol/dist/actions/permissionPrivilege.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionPrivilege.d.ts","sourceRoot":"","sources":["../../src/actions/permissionPrivilege.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,8CAA8C,CAAC;AAEtD,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,MAAM,4BAA4B,GACpC,QAAQ,CAAC;IACP,EAAE,EAAE,IAAI,CAAC;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,0BAA0B,CAAC;CAC3C,CAAC,GACF,QAAQ,CAAC;IACP,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,8BAA8B,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,0BAA0B,CAAC;CAC3C,CAAC,GACF,QAAQ,CAAC;IACP,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,oBAAoB,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,0BAA0B,CAAC;CAC3C,CAAC,CAAC;AAkEP,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,0BAA0B,GAAG,IAAI,CAGrG;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,QAAQ,CAAC;IACjE,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC,GAAG,4BAA4B,CAyChC;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,QAAQ,CAAC;IACrE,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC,GAAG,4BAA4B,CA6BhC"}

package/node_modules/@happier-dev/protocol/dist/actions/permissionPrivilege.js

@@ -0,0 +1,121 @@
+import { parseSessionPermissionModeAlias, } from '../sessionMetadata/sessionPermissionModes.js';
+function parsePermissionModeForPrivilege(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    return parseSessionPermissionModeAlias(raw);
+}
+function ordinalForSessionPermissionMode(mode) {
+    switch (mode) {
+        case 'plan':
+        case 'read-only':
+            return 0;
+        case 'default':
+            return 1;
+        case 'acceptEdits':
+        case 'safe-yolo':
+            return 2;
+        case 'bypassPermissions':
+        case 'yolo':
+            return 3;
+    }
+}
+function normalizeSupportedModes(supportedModes) {
+    if (!supportedModes || supportedModes.length === 0)
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const mode of supportedModes) {
+        if (typeof mode !== 'string')
+            continue;
+        const trimmed = mode.trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        const normalizedMode = parsePermissionModeForPrivilege(trimmed);
+        if (!normalizedMode)
+            continue;
+        seen.add(trimmed);
+        out.push({
+            requestedMode: trimmed,
+            normalizedMode,
+            ordinal: ordinalForSessionPermissionMode(normalizedMode),
+        });
+    }
+    return out;
+}
+function parseCallerPermission(rawMode) {
+    const normalizedMode = parsePermissionModeForPrivilege(rawMode) ?? 'default';
+    return {
+        mode: normalizedMode,
+        normalizedMode,
+        ordinal: ordinalForSessionPermissionMode(normalizedMode),
+    };
+}
+export function resolvePermissionPrivilegeOrdinal(rawMode) {
+    const normalizedMode = parsePermissionModeForPrivilege(rawMode);
+    return normalizedMode ? ordinalForSessionPermissionMode(normalizedMode) : null;
+}
+export function assertNonEscalatingPermissionMode(params) {
+    const caller = parseCallerPermission(params.callerMode);
+    const requestedRaw = typeof params.requestedMode === 'string' ? params.requestedMode.trim() : '';
+    const requestedMode = parsePermissionModeForPrivilege(params.requestedMode);
+    if (!requestedRaw || !requestedMode) {
+        return {
+            ok: false,
+            reason: 'invalid_parameters',
+            requestedMode: requestedRaw,
+            requestedOrdinal: null,
+            callerMode: caller.mode,
+            callerOrdinal: caller.ordinal,
+        };
+    }
+    const requestedOrdinal = ordinalForSessionPermissionMode(requestedMode);
+    const requestedSupported = normalizeSupportedModes(params.supportedModes).find((mode) => mode.normalizedMode === requestedMode || mode.requestedMode === requestedRaw);
+    const requestedOutputMode = requestedSupported?.requestedMode ?? requestedMode;
+    if (requestedOrdinal > caller.ordinal) {
+        return {
+            ok: false,
+            reason: 'permission_escalation_denied',
+            requestedMode: requestedOutputMode,
+            normalizedMode: requestedMode,
+            requestedOrdinal,
+            callerMode: caller.mode,
+            callerOrdinal: caller.ordinal,
+        };
+    }
+    return {
+        ok: true,
+        requestedMode: requestedOutputMode,
+        normalizedMode: requestedMode,
+        requestedOrdinal,
+        callerMode: caller.mode,
+        callerOrdinal: caller.ordinal,
+    };
+}
+export function resolveNearestPermissionModeAtOrBelow(params) {
+    if (typeof params.requestedMode === 'string' && params.requestedMode.trim().length > 0) {
+        return assertNonEscalatingPermissionMode(params);
+    }
+    const caller = parseCallerPermission(params.callerMode);
+    const selected = normalizeSupportedModes(params.supportedModes)
+        .filter((mode) => mode.ordinal <= caller.ordinal)
+        .sort((a, b) => b.ordinal - a.ordinal)[0];
+    if (selected) {
+        return {
+            ok: true,
+            requestedMode: selected.requestedMode,
+            normalizedMode: selected.normalizedMode,
+            requestedOrdinal: selected.ordinal,
+            callerMode: caller.mode,
+            callerOrdinal: caller.ordinal,
+        };
+    }
+    return {
+        ok: true,
+        requestedMode: caller.mode,
+        normalizedMode: caller.normalizedMode,
+        requestedOrdinal: caller.ordinal,
+        callerMode: caller.mode,
+        callerOrdinal: caller.ordinal,
+    };
+}
+//# sourceMappingURL=permissionPrivilege.js.map

package/node_modules/@happier-dev/protocol/dist/actions/permissionPrivilege.js.map

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

package/node_modules/@happier-dev/protocol/dist/actions/sessionModeIds.js

@@ -1,13 +1,13 @@
-function normalizeModeId(raw) {
-    return String(raw ?? '').trim();
+function readNonBlankModeId(raw) {
+    return typeof raw === 'string' && raw.trim().length > 0 ? raw : '';
 }
 function readOptionModeId(option) {
     if ('id' in option)
-        return normalizeModeId(option.id);
-    return normalizeModeId(option.value);
+        return readNonBlankModeId(option.id);
+    return readNonBlankModeId(option.value);
 }
 export function resolveRequestedSessionModeId(requestedModeId, options) {
-    const normalizedRequestedModeId = normalizeModeId(requestedModeId);
+    const normalizedRequestedModeId = readNonBlankModeId(requestedModeId);
     if (normalizedRequestedModeId !== 'default')
         return normalizedRequestedModeId;
     return Array.isArray(options) && options.some((option) => readOptionModeId(option) === 'default')

package/node_modules/@happier-dev/protocol/dist/actions/sessionModeIds.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionModeIds.js","sourceRoot":"","sources":["../../src/actions/sessionModeIds.ts"],"names":[],"mappings":"AAIA,SAAS,eAAe,CAAC,GAAY;IACnC,OAAO,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA6B;IACrD,IAAI,IAAI,IAAI,MAAM;QAAE,OAAO,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtD,OAAO,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,eAAuB,EACvB,OAA4D;IAE5D,MAAM,yBAAyB,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;IACnE,IAAI,yBAAyB,KAAK,SAAS;QAAE,OAAO,yBAAyB,CAAC;IAC9E,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;QAC/F,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}
+{"version":3,"file":"sessionModeIds.js","sourceRoot":"","sources":["../../src/actions/sessionModeIds.ts"],"names":[],"mappings":"AAIA,SAAS,kBAAkB,CAAC,GAAY;IACtC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA6B;IACrD,IAAI,IAAI,IAAI,MAAM;QAAE,OAAO,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,eAAuB,EACvB,OAA4D;IAE5D,MAAM,yBAAyB,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACtE,IAAI,yBAAyB,KAAK,SAAS;QAAE,OAAO,yBAAyB,CAAC;IAC9E,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;QAC/F,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/node_modules/@happier-dev/protocol/dist/actions/sessionSpawnConfigOptions.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { type AcpConfigOptionOverridesV1 } from '../sessionMetadata/metadataOverridesV1.js';
+export declare const SpawnConfigOptionValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+export type SpawnConfigOptionValue = z.infer<typeof SpawnConfigOptionValueSchema>;
+/**
+ * Read a single config-option value from canonical `AcpConfigOptionOverridesV1` by option id. This
+ * is the ONE shared reader used by both the session-spawn path and execution-run backends so effort
+ * (`reasoning_effort`) and other options are extracted identically. Returns `undefined` when the
+ * option is absent or cleared (`null`).
+ */
+export declare function readSpawnConfigOptionOverrideValue(overrides: AcpConfigOptionOverridesV1 | null | undefined, optionId: string): SpawnConfigOptionValue | undefined;
+export type SpawnConfigOptionsAliasConflict = Readonly<{
+    optionId: string;
+    canonicalValue: SpawnConfigOptionValue;
+    shorthandValue: SpawnConfigOptionValue;
+}>;
+export declare function buildAcpConfigOptionOverridesV1FromConfigOptions(params: Readonly<{
+    configOptions?: Readonly<Record<string, SpawnConfigOptionValue>> | null;
+    updatedAt?: number;
+}>): AcpConfigOptionOverridesV1 | null;
+export declare function findSpawnConfigOptionAliasConflicts(params: Readonly<{
+    sessionConfigOptionOverrides?: AcpConfigOptionOverridesV1 | null;
+    configOptions?: Readonly<Record<string, SpawnConfigOptionValue>> | null;
+}>): readonly SpawnConfigOptionsAliasConflict[];
+export declare function mergeSpawnConfigOptionAliases(params: Readonly<{
+    sessionConfigOptionOverrides?: AcpConfigOptionOverridesV1 | null;
+    configOptions?: Readonly<Record<string, SpawnConfigOptionValue>> | null;
+    updatedAt?: number;
+}>): Readonly<{
+    ok: true;
+    value: AcpConfigOptionOverridesV1 | null;
+    source: 'sessionConfigOptionOverrides' | 'configOptions' | 'sessionConfigOptionOverrides+configOptions' | null;
+} | {
+    ok: false;
+    conflicts: readonly SpawnConfigOptionsAliasConflict[];
+}>;
+//# sourceMappingURL=sessionSpawnConfigOptions.d.ts.map

package/node_modules/@happier-dev/protocol/dist/actions/sessionSpawnConfigOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionSpawnConfigOptions.d.ts","sourceRoot":"","sources":["../../src/actions/sessionSpawnConfigOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,2CAA2C,CAAC;AAEnD,eAAO,MAAM,4BAA4B,0EAA2D,CAAC;AACrG,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,0BAA0B,GAAG,IAAI,GAAG,SAAS,EACxD,QAAQ,EAAE,MAAM,GACf,sBAAsB,GAAG,SAAS,CAKpC;AAED,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,sBAAsB,CAAC;IACvC,cAAc,EAAE,sBAAsB,CAAC;CACxC,CAAC,CAAC;AAEH,wBAAgB,gDAAgD,CAAC,MAAM,EAAE,QAAQ,CAAC;IAChF,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,GAAG,0BAA0B,GAAG,IAAI,CAiBrC;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,QAAQ,CAAC;IACnE,4BAA4B,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACjE,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,GAAG,IAAI,CAAC;CACzE,CAAC,GAAG,SAAS,+BAA+B,EAAE,CAgB9C;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC7D,4BAA4B,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACjE,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,GAAG,QAAQ,CACT;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,8BAA8B,GAAG,eAAe,GAAG,4CAA4C,GAAG,IAAI,CAAA;CAAE,GACtK;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,SAAS,+BAA+B,EAAE,CAAA;CAAE,CACvE,CA8BA"}

package/node_modules/@happier-dev/protocol/dist/actions/sessionSpawnConfigOptions.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { buildAcpConfigOptionOverridesV1, } from '../sessionMetadata/metadataOverridesV1.js';
+export const SpawnConfigOptionValueSchema = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+/**
+ * Read a single config-option value from canonical `AcpConfigOptionOverridesV1` by option id. This
+ * is the ONE shared reader used by both the session-spawn path and execution-run backends so effort
+ * (`reasoning_effort`) and other options are extracted identically. Returns `undefined` when the
+ * option is absent or cleared (`null`).
+ */
+export function readSpawnConfigOptionOverrideValue(overrides, optionId) {
+    const override = overrides?.overrides?.[optionId];
+    if (!override)
+        return undefined;
+    const { value } = override;
+    return value === null ? undefined : value;
+}
+export function buildAcpConfigOptionOverridesV1FromConfigOptions(params) {
+    const entries = Object.entries(params.configOptions ?? {})
+        .filter(([id]) => id.trim().length > 0);
+    if (entries.length === 0)
+        return null;
+    const updatedAt = typeof params.updatedAt === 'number' && Number.isFinite(params.updatedAt)
+        ? params.updatedAt
+        : Date.now();
+    return buildAcpConfigOptionOverridesV1({
+        updatedAt,
+        overrides: Object.fromEntries(entries.map(([id, value]) => [
+            id,
+            { updatedAt, value },
+        ])),
+    });
+}
+export function findSpawnConfigOptionAliasConflicts(params) {
+    const canonical = params.sessionConfigOptionOverrides;
+    const shorthand = params.configOptions;
+    if (!canonical || !shorthand)
+        return [];
+    const conflicts = [];
+    for (const [optionId, shorthandValue] of Object.entries(shorthand)) {
+        const canonicalOverride = canonical.overrides[optionId];
+        if (!canonicalOverride || Object.is(canonicalOverride.value, shorthandValue))
+            continue;
+        conflicts.push({
+            optionId,
+            canonicalValue: canonicalOverride.value,
+            shorthandValue,
+        });
+    }
+    return conflicts;
+}
+export function mergeSpawnConfigOptionAliases(params) {
+    const conflicts = findSpawnConfigOptionAliasConflicts(params);
+    if (conflicts.length > 0)
+        return { ok: false, conflicts };
+    const canonical = params.sessionConfigOptionOverrides ?? null;
+    const shorthand = buildAcpConfigOptionOverridesV1FromConfigOptions({
+        configOptions: params.configOptions,
+        updatedAt: params.updatedAt,
+    });
+    if (!canonical) {
+        return shorthand
+            ? { ok: true, value: shorthand, source: 'configOptions' }
+            : { ok: true, value: null, source: null };
+    }
+    if (!shorthand) {
+        return { ok: true, value: canonical, source: 'sessionConfigOptionOverrides' };
+    }
+    return {
+        ok: true,
+        value: {
+            ...canonical,
+            overrides: {
+                ...shorthand.overrides,
+                ...canonical.overrides,
+            },
+        },
+        source: 'sessionConfigOptionOverrides+configOptions',
+    };
+}
+//# sourceMappingURL=sessionSpawnConfigOptions.js.map

package/node_modules/@happier-dev/protocol/dist/actions/sessionSpawnConfigOptions.js.map

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

package/node_modules/@happier-dev/protocol/dist/activity/backgroundTask/backgroundTaskRecordV1.d.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+/**
+ * Longest label this record may persist.
+ *
+ * The bound is the redaction contract's, not a display preference: `redactBackgroundCommand`
+ * truncates to exactly this many characters, so a label that exceeds it did not come through
+ * redaction. Failing the parse is therefore the last gate before an unredacted command reaches
+ * persistence and every client.
+ */
+export declare const BACKGROUND_TASK_LABEL_MAX = 120;
+/**
+ * Longest provider summary this record may persist.
+ *
+ * `task_notification.summary` is provider prose of unbounded length (OBSERVED: the SDK types it as
+ * a plain `string`), and this record is synced to every client on every read, so it is bounded here
+ * rather than at each renderer.
+ */
+export declare const BACKGROUND_TASK_SUMMARY_MAX = 2000;
+/**
+ * What a background task IS, as one classified bucket.
+ *
+ * Not the provider's `task_type`. The raw type drifts — t3code's production note records an
+ * allowlist that silently dropped real subagents when `local_agent` appeared — so the CLI classifies
+ * once at ingestion and persists the answer, and every renderer reads the answer instead of
+ * re-deriving it from a string it does not own.
+ *
+ * Distinct from `AgentActivityKindV1`, which says what kind of ROW a piece of agent activity is.
+ * This says which kind of headless work one background task is, and only ever describes tasks that
+ * already failed the "is this an agent?" question.
+ *
+ * - `command` — a shell that outlives its turn (`local_bash`, `shell`).
+ * - `monitoring` — a watch loop (`monitor`, `monitor_mcp`). Recognised now so that a provider that
+ *   starts emitting these classifies them instead of dropping them; PLAN §4.9.2 ships no monitor
+ *   row, action or schedule model, because no producer is verified.
+ * - `unknown` — fully typed, admitted, but of a type this build does not recognise. PLAN §4.9.1
+ *   step 5 degrades such a task to background rather than guessing that it is an agent.
+ */
+export declare const BACKGROUND_TASK_KINDS_V1: readonly ['command', 'monitoring', 'unknown'];
+export declare const BackgroundTaskKindV1Schema: z.ZodEnum<{
+    command: "command";
+    monitoring: "monitoring";
+    unknown: "unknown";
+}>;
+export type BackgroundTaskKindV1 = z.infer<typeof BackgroundTaskKindV1Schema>;
+/**
+ * Durable outcome record for ONE Claude background task, persisted as a session system record
+ * under namespace `activity`, kind `background_task.v1`.
+ *
+ * **Only attested fields.** Every field below is one this program has seen a provider payload
+ * carry, and the record deliberately lacks the ones it has not:
+ *
+ * - **No `cwd`.** It appears in no observed Claude task payload (checked against the recorded
+ *   fixtures in `apps/cli/src/backends/claude/workflows/__fixtures__/**` and the SDK's declared
+ *   `SDKTaskStarted/Progress/Notification/Updated` message types). A detail view degrades to the
+ *   progress line or the status alone.
+ * - **No output.** `stdout`/`stderr` arrive on the originating `Bash` tool result, which is where
+ *   the transcript already renders them. A second copy here would be a second authority.
+ * - **No retention promise.** There is no TTL mechanism, so no field or copy may imply one.
+ *
+ * Liveness is NOT stored here. The in-memory provider ledger owns "is this task still running" and
+ * is rebuildable; this record owns the durable outcome (PLAN §4.9).
+ *
+ * `.strip()` rather than the `.passthrough()` its `workflow_run.v1` sibling uses, and deliberately:
+ * this record is the one place a redaction bug could persist a raw command, so the schema is a
+ * chokepoint that drops anything the contract does not name instead of forwarding it.
+ */
+export declare const SessionBackgroundTaskRecordV1Schema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    kind: z.ZodEnum<{
+        command: "command";
+        monitoring: "monitoring";
+        unknown: "unknown";
+    }>;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        cancelled: "cancelled";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        starting: "starting";
+        succeeded: "succeeded";
+        timedOut: "timedOut";
+        unknown: "unknown";
+        waiting: "waiting";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    endedAt: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type SessionBackgroundTaskRecordV1 = z.infer<typeof SessionBackgroundTaskRecordV1Schema>;
+//# sourceMappingURL=backgroundTaskRecordV1.d.ts.map