@canonmsg/backend-contracts 6.4.0 → 8.0.0

package/dist/verbContract.d.ts

@@ -42,7 +42,6 @@
  * `findVerbByteLimitViolations()` (or equivalent checks from the emitted
  * canon-verbs.limits.json) after schema validation.
  */
-import type { ContactRequestRequirements } from './contactRequest.js';
 /** Identifier for this contract document. */
 export declare const CANON_VERBS_SCHEMA_VERSION = "canon.verbs.v1";
 /** $id of the emitted JSON Schema bundle. */
@@ -73,10 +72,7 @@ export declare const VERB_ID_PATTERNS: {
     readonly sessionRuleToolPattern: "^[\\w.*:-]{1,128}$";
     readonly runtimeCorrelationValue: "^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$";
     readonly runtimeMethod: "^[A-Za-z0-9_][A-Za-z0-9_./:\\-]{0,255}$";
-    readonly runtimeOptionValue: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-    readonly workspaceOptionId: "^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$";
     readonly runtimeHandleKey: "^[A-Za-z0-9_.:-]{1,80}$";
-    readonly runtimeControlId: "^[A-Za-z0-9_-]{1,80}$";
     /** UUID issued by Canon's resumable-media session endpoint. */
     readonly resumableUploadId: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$";
 };
@@ -146,9 +142,6 @@ export declare const VERB_LIMITS: {
     readonly nativeKeys: 24;
     readonly nativeValueChars: 256;
     readonly nativeHandles: 16;
-    /** Initial agent-session setup carried by send_to. */
-    readonly sessionConfigValues: 24;
-    readonly sessionConfigValueChars: 256;
     /** Deadlines (functions/src/utils/runtimeRequestHelpers.ts). */
     readonly minTimeoutMs: 1000;
     /** input/card/plan ceiling (30 minutes). */
@@ -184,7 +177,7 @@ export declare const VERB_RATE_LIMITS: {
 /** The one self-context type the platform accepts today. */
 export declare const SELF_CONTEXT_TYPE = "cross_session";
 /** Canonical verb names. */
-export declare const CANON_VERB_NAMES: readonly ["send_to", "request_input", "request_approval", "check_approval", "send_card", "request_card", "share_contact", "react", "forward", "create_group", "add_member", "remove_member", "leave_conversation", "list_contacts", "list_contact_requests", "list_conversations", "cancel_contact_request", "no_reply"];
+export declare const CANON_VERB_NAMES: readonly ["send_to", "request_input", "request_approval", "check_approval", "send_card", "request_card", "share_contact", "react", "forward", "create_group", "add_member", "remove_member", "leave_conversation", "list_contacts", "list_conversations", "no_reply"];
 export type CanonVerbName = (typeof CANON_VERB_NAMES)[number];
 /** Private note-to-self attached to a cross-conversation send. */
 export interface VerbSelfContext {
@@ -202,20 +195,6 @@ export type VerbSessionSelection = {
     mode: 'specific';
     conversationId: string;
 };
-/**
- * Public setup policy for the target agent session. Every value is a stable
- * runtime-advertised option id, never a label, prompt, path, or other free
- * text. The server also validates each selection against the target's live
- * descriptor before creating a session.
- */
-export interface VerbSessionConfig {
-    model?: string;
-    permissionMode?: string;
-    effort?: string;
-    runtimeControlValues?: Record<string, string>;
-    workspaceId?: string;
-    executionMode?: 'worktree' | 'locked';
-}
 /**
  * Bounded runtime correlation carried in the public wire envelope. These are
  * opaque identifiers only; workspace paths, commands, prompts, summaries,
@@ -268,7 +247,6 @@ export interface VerbMediaAttachment {
  */
 export interface VerbTurnMetadata {
     turnId?: string | null;
-    sourceMessageId?: string;
     turnSemantics?: 'progress' | 'turn_complete' | 'control';
     deliveryIntent?: 'queue' | 'interrupt' | 'interleave' | 'stop';
     replyBehavior?: 'allow_auto_reply' | 'suppress_auto_reply';
@@ -312,8 +290,6 @@ export interface SendToInput {
     requestMessage?: string;
     /** Only meaningful for user targets that are agents. Default: continue_or_create. */
     sessionSelection?: VerbSessionSelection;
-    /** Coding-agent session setup; only applied when the target is an agent. */
-    sessionConfig?: VerbSessionConfig | null;
     messageOptions?: VerbMessageOptions;
 }
 export type SendToResult = {
@@ -323,7 +299,7 @@ export type SendToResult = {
     selfContextId?: string;
     created?: boolean;
     reused?: boolean;
-    sessionSelection?: VerbSessionSelection['mode'];
+    sessionSelection?: string;
 } | {
     status: 'requested';
     requestId: string | null;
@@ -614,17 +590,16 @@ export interface CreateGroupInput {
 export interface PendingGroupInviteResult {
     userId: string;
     requestId: string;
-    requirements: ContactRequestRequirements;
 }
 export interface CreateGroupResult {
     status: 'created';
     conversationId: string;
     /** Members admitted synchronously during creation. */
     added: string[];
-    /** group_invite requests awaiting policy approval, owner setup, or both. */
+    /** group_invite requests awaiting exact policy approval. */
     pending: PendingGroupInviteResult[];
     /** Members the staged create could not admit: hard policy denials
-     * (owner-only, blocked, inactive, not-found, …). */
+     * (closed, blocked, inactive, not-found, …). */
     skipped: Array<{
         userId: string;
         reason: string;
@@ -636,25 +611,16 @@ export interface CreateGroupResult {
  * invite is allowed; the error detail carries the attempted partition.
  */
 export declare const CREATE_GROUP_NO_ADDABLE_MEMBERS_CODE = "CREATE_GROUP_NO_ADDABLE_MEMBERS";
-/**
- * Error code on the 403 a create_group receives when the CREATOR itself is
- * a coding agent requiring explicit session setup: the group helper prepares
- * session configs for every coding-agent member including the creator, and
- * only the agent's human owner may provide them (v1 scoping — the owner
- * creates the group from the app instead).
- */
-export declare const CREATE_GROUP_CREATOR_SETUP_REQUIRED_CODE = "CREATE_GROUP_CREATOR_SETUP_REQUIRED";
 export interface AddMemberInput {
     conversationId: string;
     userId: string;
 }
-/** Policy approval and/or required owner setup yield one pending group invite. */
+/** Policy approval yields one exact pending group invite. */
 export type AddMemberResult = {
     status: 'added';
 } | {
     status: 'pending';
     requestId: string;
-    requirements: ContactRequestRequirements;
 };
 export interface RemoveMemberInput {
     conversationId: string;
@@ -681,26 +647,6 @@ export interface VerbContact {
 export interface ListContactsResult {
     contacts: VerbContact[];
 }
-export type ContactRequestListDirection = 'inbound' | 'outbound';
-export interface ListContactRequestsInput {
-    /** Defaults to inbound. Outbound is the reconnect/recovery surface. */
-    direction?: ContactRequestListDirection;
-    /** Include terminal and starting lifecycle states; default false. */
-    includeResolved?: boolean;
-    /** Newest-first result cap; default and maximum 100. */
-    limit?: number;
-}
-/** Items are SerializedContactRequest (contactRequest.ts), newest first, capped at 100. */
-export interface ListContactRequestsResult {
-    requests: unknown[];
-}
-export interface CancelContactRequestInput {
-    requestId: string;
-}
-export interface CancelContactRequestResult {
-    status: 'cancelled';
-    requestId: string;
-}
 export interface ListConversationsInput {
     /** Optional client-side cap; the REST endpoint returns all memberships. */
     limit?: number;
@@ -827,9 +773,6 @@ export declare const CANON_VERB_LIMITS_ARTIFACT: {
         readonly nativeKeys: 24;
         readonly nativeValueChars: 256;
         readonly nativeHandles: 16;
-        /** Initial agent-session setup carried by send_to. */
-        readonly sessionConfigValues: 24;
-        readonly sessionConfigValueChars: 256;
         /** Deadlines (functions/src/utils/runtimeRequestHelpers.ts). */
         readonly minTimeoutMs: 1000;
         /** input/card/plan ceiling (30 minutes). */
@@ -865,10 +808,7 @@ export declare const CANON_VERB_LIMITS_ARTIFACT: {
         readonly sessionRuleToolPattern: "^[\\w.*:-]{1,128}$";
         readonly runtimeCorrelationValue: "^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$";
         readonly runtimeMethod: "^[A-Za-z0-9_][A-Za-z0-9_./:\\-]{0,255}$";
-        readonly runtimeOptionValue: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-        readonly workspaceOptionId: "^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$";
         readonly runtimeHandleKey: "^[A-Za-z0-9_.:-]{1,80}$";
-        readonly runtimeControlId: "^[A-Za-z0-9_-]{1,80}$";
         /** UUID issued by Canon's resumable-media session endpoint. */
         readonly resumableUploadId: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$";
     };

package/dist/verbContract.js

@@ -72,10 +72,7 @@ export const VERB_ID_PATTERNS = {
     sessionRuleToolPattern: '^[\\w.*:-]{1,128}$',
     runtimeCorrelationValue: '^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$',
     runtimeMethod: '^[A-Za-z0-9_][A-Za-z0-9_./:\\-]{0,255}$',
-    runtimeOptionValue: '^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$',
-    workspaceOptionId: '^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$',
     runtimeHandleKey: '^[A-Za-z0-9_.:-]{1,80}$',
-    runtimeControlId: '^[A-Za-z0-9_-]{1,80}$',
     /** UUID issued by Canon's resumable-media session endpoint. */
     resumableUploadId: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$',
 };
@@ -145,9 +142,6 @@ export const VERB_LIMITS = {
     nativeKeys: 24,
     nativeValueChars: 256,
     nativeHandles: 16,
-    /** Initial agent-session setup carried by send_to. */
-    sessionConfigValues: 24,
-    sessionConfigValueChars: 256,
     /** Deadlines (functions/src/utils/runtimeRequestHelpers.ts). */
     minTimeoutMs: 1000,
     /** input/card/plan ceiling (30 minutes). */
@@ -198,9 +192,7 @@ export const CANON_VERB_NAMES = [
     'remove_member',
     'leave_conversation',
     'list_contacts',
-    'list_contact_requests',
     'list_conversations',
-    'cancel_contact_request',
     'no_reply',
 ];
 export const VERB_NATIVE_METADATA_KEYS = [
@@ -268,14 +260,6 @@ export function normalizeVerbNativeMetadata(value) {
  * invite is allowed; the error detail carries the attempted partition.
  */
 export const CREATE_GROUP_NO_ADDABLE_MEMBERS_CODE = 'CREATE_GROUP_NO_ADDABLE_MEMBERS';
-/**
- * Error code on the 403 a create_group receives when the CREATOR itself is
- * a coding agent requiring explicit session setup: the group helper prepares
- * session configs for every coding-agent member including the creator, and
- * only the agent's human owner may provide them (v1 scoping — the owner
- * creates the group from the app instead).
- */
-export const CREATE_GROUP_CREATOR_SETUP_REQUIRED_CODE = 'CREATE_GROUP_CREATOR_SETUP_REQUIRED';
 /**
  * The `note` the server returns on a `no_reply` ack — the model's closure
  * sentence. It lives here, not in a host, because every binding surfaces the

package/dist/verbSchemas.d.ts

@@ -123,51 +123,6 @@ export declare const VERB_NATIVE_METADATA_JSON_SCHEMA: {
         };
     };
 };
-export declare const VERB_SESSION_CONFIG_JSON_SCHEMA: {
-    readonly type: "object";
-    readonly description: string;
-    readonly additionalProperties: false;
-    readonly properties: {
-        readonly model: {
-            readonly type: "string";
-            readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-            readonly maxLength: 256;
-        };
-        readonly permissionMode: {
-            readonly type: "string";
-            readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-            readonly maxLength: 256;
-        };
-        readonly effort: {
-            readonly type: "string";
-            readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-            readonly maxLength: 256;
-        };
-        readonly workspaceId: {
-            readonly type: "string";
-            readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$";
-            readonly maxLength: 256;
-        };
-        readonly executionMode: {
-            readonly enum: readonly ["worktree", "locked"];
-        };
-        readonly runtimeControlValues: {
-            readonly type: "object";
-            readonly maxProperties: 24;
-            readonly propertyNames: {
-                readonly pattern: "^[A-Za-z0-9_-]{1,80}$";
-                readonly not: {
-                    readonly enum: readonly ["model", "workspace", "executionMode", "permissionMode", "effort", "interrupt", "runtimeControlValues", "updatedAt", "updatedBy"];
-                };
-            };
-            readonly additionalProperties: {
-                readonly type: "string";
-                readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-                readonly maxLength: 256;
-            };
-        };
-    };
-};
 export declare const CANON_VERBS_JSON_SCHEMA: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
     readonly $id: "https://canonmsg.com/schemas/canon.verbs.v1.json";
@@ -183,20 +138,6 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
             };
             readonly description: string;
         };
-        readonly groupInviteRequirements: {
-            readonly type: "object";
-            readonly description: string;
-            readonly required: readonly ["policyApproval", "ownerSessionSetup"];
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly policyApproval: {
-                    readonly type: "boolean";
-                };
-                readonly ownerSessionSetup: {
-                    readonly type: "boolean";
-                };
-            };
-        };
         readonly selfContext: {
             readonly type: "object";
             readonly description: string;
@@ -633,51 +574,6 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                 };
             };
         };
-        readonly sessionConfig: {
-            readonly type: "object";
-            readonly description: string;
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly model: {
-                    readonly type: "string";
-                    readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-                    readonly maxLength: 256;
-                };
-                readonly permissionMode: {
-                    readonly type: "string";
-                    readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-                    readonly maxLength: 256;
-                };
-                readonly effort: {
-                    readonly type: "string";
-                    readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-                    readonly maxLength: 256;
-                };
-                readonly workspaceId: {
-                    readonly type: "string";
-                    readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:@+\\-]{0,255}$";
-                    readonly maxLength: 256;
-                };
-                readonly executionMode: {
-                    readonly enum: readonly ["worktree", "locked"];
-                };
-                readonly runtimeControlValues: {
-                    readonly type: "object";
-                    readonly maxProperties: 24;
-                    readonly propertyNames: {
-                        readonly pattern: "^[A-Za-z0-9_-]{1,80}$";
-                        readonly not: {
-                            readonly enum: readonly ["model", "workspace", "executionMode", "permissionMode", "effort", "interrupt", "runtimeControlValues", "updatedAt", "updatedBy"];
-                        };
-                    };
-                    readonly additionalProperties: {
-                        readonly type: "string";
-                        readonly pattern: "^[A-Za-z0-9@_][A-Za-z0-9_.:/@+\\-]{0,255}$";
-                        readonly maxLength: 256;
-                    };
-                };
-            };
-        };
         readonly send_to_input: {
             readonly type: "object";
             readonly description: string;
@@ -716,14 +612,6 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                 readonly sessionSelection: {
                     $ref: string;
                 };
-                readonly sessionConfig: {
-                    readonly oneOf: readonly [{
-                        $ref: string;
-                    }, {
-                        readonly type: "null";
-                    }];
-                    readonly description: string;
-                };
                 readonly messageOptions: {
                     $ref: string;
                 };
@@ -1452,7 +1340,7 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                     readonly type: "array";
                     readonly items: {
                         readonly type: "object";
-                        readonly required: readonly ["userId", "requestId", "requirements"];
+                        readonly required: readonly ["userId", "requestId"];
                         readonly additionalProperties: true;
                         readonly properties: {
                             readonly userId: {
@@ -1461,9 +1349,6 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                             readonly requestId: {
                                 readonly type: "string";
                             };
-                            readonly requirements: {
-                                $ref: string;
-                            };
                         };
                     };
                 };
@@ -1502,7 +1387,7 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
             };
         };
         readonly add_member_result: {
-            readonly description: string;
+            readonly description: "Targets needing policy approval yield an exact pending group invite.";
             readonly oneOf: readonly [{
                 readonly type: "object";
                 readonly required: readonly ["status"];
@@ -1514,7 +1399,7 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                 };
             }, {
                 readonly type: "object";
-                readonly required: readonly ["status", "requestId", "requirements"];
+                readonly required: readonly ["status", "requestId"];
                 readonly additionalProperties: true;
                 readonly properties: {
                     readonly status: {
@@ -1523,9 +1408,6 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                     readonly requestId: {
                         readonly type: "string";
                     };
-                    readonly requirements: {
-                        $ref: string;
-                    };
                 };
             }];
         };
@@ -1612,71 +1494,6 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                 };
             };
         };
-        readonly list_contact_requests_input: {
-            readonly type: "object";
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly direction: {
-                    readonly enum: readonly ["inbound", "outbound"];
-                };
-                readonly includeResolved: {
-                    readonly type: "boolean";
-                };
-                readonly limit: {
-                    readonly type: "integer";
-                    readonly minimum: 1;
-                    readonly maximum: 100;
-                };
-            };
-        };
-        readonly list_contact_requests_result: {
-            readonly type: "object";
-            readonly description: string;
-            readonly required: readonly ["requests"];
-            readonly additionalProperties: true;
-            readonly properties: {
-                readonly requests: {
-                    readonly type: "array";
-                    readonly items: {
-                        readonly type: "object";
-                        readonly required: readonly ["id", "requesterId", "targetId", "status", "kind", "phase"];
-                        readonly additionalProperties: true;
-                        readonly properties: {
-                            readonly id: {
-                                readonly type: "string";
-                            };
-                            readonly requesterId: {
-                                readonly type: "string";
-                            };
-                            readonly requesterName: {
-                                readonly type: "string";
-                            };
-                            readonly targetId: {
-                                readonly type: "string";
-                            };
-                            readonly status: {
-                                readonly enum: readonly ["pending", "approved", "rejected", "expired", "cancelled"];
-                            };
-                            readonly kind: {
-                                readonly enum: readonly ["dm", "group_invite"];
-                            };
-                            readonly phase: {
-                                readonly enum: readonly ["awaiting_owner", "starting", "connected", "rejected", "expired", "cancelled", "failed"];
-                            };
-                            readonly message: {
-                                readonly type: readonly ["string", "null"];
-                            };
-                            readonly createdAt: {
-                                readonly type: readonly ["string", "null"];
-                            };
-                            readonly expiresAt: {
-                                readonly type: readonly ["string", "null"];
-                            };
-                        };
-                    };
-                };
-            };
-        };
         readonly list_conversations_input: {
             readonly type: "object";
             readonly additionalProperties: false;
@@ -1756,30 +1573,6 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                 };
             };
         };
-        readonly cancel_contact_request_input: {
-            readonly type: "object";
-            readonly required: readonly ["requestId"];
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly requestId: {
-                    readonly type: "string";
-                    readonly pattern: "^[A-Za-z0-9_.:-]{1,160}$";
-                };
-            };
-        };
-        readonly cancel_contact_request_result: {
-            readonly type: "object";
-            readonly required: readonly ["status", "requestId"];
-            readonly additionalProperties: true;
-            readonly properties: {
-                readonly status: {
-                    readonly const: "cancelled";
-                };
-                readonly requestId: {
-                    readonly type: "string";
-                };
-            };
-        };
         readonly no_reply_input: {
             readonly type: "object";
             readonly description: string;