@canonmsg/backend-contracts 8.0.1 → 8.1.1

package/dist/agentDirectory.d.ts

@@ -0,0 +1,29 @@
+import type { CommunicationRule } from './communication.js';
+/** Shared paging bounds for Canon's discoverable-agent directory. */
+export declare const DEFAULT_DISCOVER_AGENTS_LIMIT = 20;
+export declare const MAX_DISCOVER_AGENTS_LIMIT = 25;
+export declare const MAX_DISCOVER_AGENTS_QUERY_LENGTH = 64;
+export interface DiscoverAgentsInput {
+    query?: string;
+    limit?: number;
+    cursor?: string | null;
+}
+/** Public, addressable identity returned to an authenticated agent caller. */
+export interface CanonAgentDirectoryEntry {
+    principalId: string;
+    canonContactId?: string;
+    displayName?: string;
+    description?: string;
+    /** Human principal accountable for this agent. */
+    owner: {
+        principalId: string;
+        displayName?: string;
+    };
+    inboundPolicy?: CommunicationRule;
+    groupJoinPolicy?: CommunicationRule;
+    shareable: boolean;
+}
+export interface DiscoverAgentsResult {
+    agents: CanonAgentDirectoryEntry[];
+    nextCursor: string | null;
+}

package/dist/agentDirectory.js

@@ -0,0 +1,4 @@
+/** Shared paging bounds for Canon's discoverable-agent directory. */
+export const DEFAULT_DISCOVER_AGENTS_LIMIT = 20;
+export const MAX_DISCOVER_AGENTS_LIMIT = 25;
+export const MAX_DISCOVER_AGENTS_QUERY_LENGTH = 64;

package/dist/cjs/agentDirectory.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_DISCOVER_AGENTS_QUERY_LENGTH = exports.MAX_DISCOVER_AGENTS_LIMIT = exports.DEFAULT_DISCOVER_AGENTS_LIMIT = void 0;
+/** Shared paging bounds for Canon's discoverable-agent directory. */
+exports.DEFAULT_DISCOVER_AGENTS_LIMIT = 20;
+exports.MAX_DISCOVER_AGENTS_LIMIT = 25;
+exports.MAX_DISCOVER_AGENTS_QUERY_LENGTH = 64;

package/dist/cjs/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./runtimeCardStorage.js"), exports);
 __exportStar(require("./turnProtocol.js"), exports);
 __exportStar(require("./agentBehaviorPolicy.js"), exports);
 __exportStar(require("./agentSearch.js"), exports);
+__exportStar(require("./agentDirectory.js"), exports);
 __exportStar(require("./verbContract.js"), exports);
 __exportStar(require("./verbSchemas.js"), exports);
 __exportStar(require("./verbWire.js"), exports);

package/dist/cjs/turnProtocol.js

@@ -118,6 +118,13 @@ function shouldPromoteConversationMessage(input) {
     if (isHiddenRuntimeCardMetadata(input.metadata)) {
         return false;
     }
+    // Ordinary agent speech can update previews and notify people without
+    // opting into automatic agent-to-agent turns. Keep malformed explicit
+    // semantics on the existing conservative fallback.
+    if (input.metadata == null
+        || (isRecord(input.metadata) && input.metadata.turnSemantics === undefined)) {
+        return true;
+    }
     return resolveTurnMessageSemantics(input) !== 'progress';
 }
 function shouldTriggerAgentTurn(input) {

package/dist/communication.d.ts

@@ -1,3 +1,4 @@
+import type { DiscoverAgentsInput, DiscoverAgentsResult } from './agentDirectory.js';
 /** The deliberately small policy vocabulary for principal communication. */
 export type CommunicationRule = 'open' | 'approval-required' | 'closed';
 /** Missing or invalid policy never widens access. */
@@ -11,7 +12,9 @@ export type DirectConversationSelection = {
     mode: 'specific';
     conversationId: string;
 };
-export type CommunicateInput = {
+export type CommunicateInput = ({
+    action: 'discover_agents';
+} & DiscoverAgentsInput) | {
     action: 'message_existing';
     conversationId: string;
     text: string;
@@ -44,7 +47,9 @@ export type CommunicateInput = {
     userId: string;
     operation: 'add' | 'remove';
 };
-export type CommunicateResult = {
+export type CommunicateResult = ({
+    status: 'discovered';
+} & DiscoverAgentsResult) | {
     status: 'messaged';
     conversationId: string;
     messageId: string;

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './runtimeCardStorage.js';
 export * from './turnProtocol.js';
 export * from './agentBehaviorPolicy.js';
 export * from './agentSearch.js';
+export * from './agentDirectory.js';
 export * from './verbContract.js';
 export * from './verbSchemas.js';
 export * from './verbWire.js';

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './runtimeCardStorage.js';
 export * from './turnProtocol.js';
 export * from './agentBehaviorPolicy.js';
 export * from './agentSearch.js';
+export * from './agentDirectory.js';
 export * from './verbContract.js';
 export * from './verbSchemas.js';
 export * from './verbWire.js';

package/dist/turnProtocol.js

@@ -107,6 +107,13 @@ export function shouldPromoteConversationMessage(input) {
     if (isHiddenRuntimeCardMetadata(input.metadata)) {
         return false;
     }
+    // Ordinary agent speech can update previews and notify people without
+    // opting into automatic agent-to-agent turns. Keep malformed explicit
+    // semantics on the existing conservative fallback.
+    if (input.metadata == null
+        || (isRecord(input.metadata) && input.metadata.turnSemantics === undefined)) {
+        return true;
+    }
     return resolveTurnMessageSemantics(input) !== 'progress';
 }
 export function shouldTriggerAgentTurn(input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/backend-contracts",
-  "version": "8.0.1",
+  "version": "8.1.1",
   "description": "Canon backend contract helpers shared by Functions and stream-service",
   "type": "module",
   "main": "dist/cjs/index.js",