@stigmer/protos 3.5.3 → 3.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ai/stigmer/agentic/agentchannel/v1/conversation_command_connect.d.ts +141 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_command_connect.js +149 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_command_connect.js.map +1 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_command_pb.d.ts +140 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_command_pb.js +34 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_command_pb.js.map +1 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb.d.ts +541 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb.js +181 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb.js.map +1 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_query_connect.d.ts +69 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_query_connect.js +76 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_query_connect.js.map +1 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_query_pb.d.ts +70 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_query_pb.js +30 -0
- package/ai/stigmer/agentic/agentchannel/v1/conversation_query_pb.js.map +1 -0
- package/ai/stigmer/agentic/agentchannel/v1/delivery_pb.d.ts +36 -2
- package/ai/stigmer/agentic/agentchannel/v1/delivery_pb.js +18 -2
- package/ai/stigmer/agentic/agentchannel/v1/delivery_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentchannel/v1/message_io_pb.d.ts +90 -0
- package/ai/stigmer/agentic/agentchannel/v1/message_io_pb.js +16 -1
- package/ai/stigmer/agentic/agentchannel/v1/message_io_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentchannel/v1/message_query_connect.d.ts +27 -0
- package/ai/stigmer/agentic/agentchannel/v1/message_query_connect.js +28 -1
- package/ai/stigmer/agentic/agentchannel/v1/message_query_connect.js.map +1 -1
- package/ai/stigmer/agentic/agentchannel/v1/message_query_pb.d.ts +27 -1
- package/ai/stigmer/agentic/agentchannel/v1/message_query_pb.js +1 -1
- package/ai/stigmer/agentic/agentchannel/v1/message_query_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentchannel/v1/outbound_pb.d.ts +142 -6
- package/ai/stigmer/agentic/agentchannel/v1/outbound_pb.js +94 -5
- package/ai/stigmer/agentic/agentchannel/v1/outbound_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentchannel/v1/spec_pb.d.ts +25 -0
- package/ai/stigmer/agentic/agentchannel/v1/spec_pb.js +2 -1
- package/ai/stigmer/agentic/agentchannel/v1/spec_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentexecution/v1/api_pb.d.ts +5 -1
- package/ai/stigmer/agentic/agentexecution/v1/api_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentexecution/v1/enum_pb.d.ts +66 -0
- package/ai/stigmer/agentic/agentexecution/v1/enum_pb.js +81 -14
- package/ai/stigmer/agentic/agentexecution/v1/enum_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentexecution/v1/invocation_pb.d.ts +210 -0
- package/ai/stigmer/agentic/agentexecution/v1/invocation_pb.js +25 -0
- package/ai/stigmer/agentic/agentexecution/v1/invocation_pb.js.map +1 -0
- package/ai/stigmer/agentic/agentexecution/v1/io_pb.d.ts +17 -0
- package/ai/stigmer/agentic/agentexecution/v1/io_pb.js +1 -1
- package/ai/stigmer/agentic/agentexecution/v1/io_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentexecution/v1/spec_pb.d.ts +13 -1
- package/ai/stigmer/agentic/agentexecution/v1/spec_pb.js +1 -1
- package/ai/stigmer/agentic/agentexecution/v1/spec_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentexecution/v1/usage_pb.d.ts +33 -1
- package/ai/stigmer/agentic/agentexecution/v1/usage_pb.js +2 -1
- package/ai/stigmer/agentic/agentexecution/v1/usage_pb.js.map +1 -1
- package/ai/stigmer/agentic/agentshare/v1/spec_pb.d.ts +27 -0
- package/ai/stigmer/agentic/agentshare/v1/spec_pb.js +2 -1
- package/ai/stigmer/agentic/agentshare/v1/spec_pb.js.map +1 -1
- package/ai/stigmer/agentic/mcpserver/v1/spec_pb.d.ts +26 -0
- package/ai/stigmer/agentic/mcpserver/v1/spec_pb.js.map +1 -1
- package/ai/stigmer/agentic/schedule/v1/api_pb.d.ts +68 -0
- package/ai/stigmer/agentic/schedule/v1/api_pb.js +18 -0
- package/ai/stigmer/agentic/schedule/v1/api_pb.js.map +1 -0
- package/ai/stigmer/agentic/schedule/v1/command_connect.d.ts +189 -0
- package/ai/stigmer/agentic/schedule/v1/command_connect.js +197 -0
- package/ai/stigmer/agentic/schedule/v1/command_connect.js.map +1 -0
- package/ai/stigmer/agentic/schedule/v1/command_pb.d.ts +187 -0
- package/ai/stigmer/agentic/schedule/v1/command_pb.js +19 -0
- package/ai/stigmer/agentic/schedule/v1/command_pb.js.map +1 -0
- package/ai/stigmer/agentic/schedule/v1/io_pb.d.ts +387 -0
- package/ai/stigmer/agentic/schedule/v1/io_pb.js +150 -0
- package/ai/stigmer/agentic/schedule/v1/io_pb.js.map +1 -0
- package/ai/stigmer/agentic/schedule/v1/query_connect.d.ts +103 -0
- package/ai/stigmer/agentic/schedule/v1/query_connect.js +112 -0
- package/ai/stigmer/agentic/schedule/v1/query_connect.js.map +1 -0
- package/ai/stigmer/agentic/schedule/v1/query_pb.d.ts +103 -0
- package/ai/stigmer/agentic/schedule/v1/query_pb.js +25 -0
- package/ai/stigmer/agentic/schedule/v1/query_pb.js.map +1 -0
- package/ai/stigmer/agentic/schedule/v1/spec_pb.d.ts +132 -0
- package/ai/stigmer/agentic/schedule/v1/spec_pb.js +16 -0
- package/ai/stigmer/agentic/schedule/v1/spec_pb.js.map +1 -0
- package/ai/stigmer/agentic/schedule/v1/status_pb.d.ts +85 -0
- package/ai/stigmer/agentic/schedule/v1/status_pb.js +16 -0
- package/ai/stigmer/agentic/schedule/v1/status_pb.js.map +1 -0
- package/ai/stigmer/agentic/session/v1/enum_pb.d.ts +10 -8
- package/ai/stigmer/agentic/session/v1/enum_pb.js +10 -8
- package/ai/stigmer/agentic/session/v1/enum_pb.js.map +1 -1
- package/ai/stigmer/agentic/session/v1/spec_pb.d.ts +7 -5
- package/ai/stigmer/agentic/session/v1/spec_pb.js.map +1 -1
- package/ai/stigmer/agentic/workflow/v1/tasks/agent_call_pb.d.ts +123 -104
- package/ai/stigmer/agentic/workflow/v1/tasks/agent_call_pb.js +4 -7
- package/ai/stigmer/agentic/workflow/v1/tasks/agent_call_pb.js.map +1 -1
- package/ai/stigmer/agentic/workflowexecution/v1/io_pb.d.ts +17 -0
- package/ai/stigmer/agentic/workflowexecution/v1/io_pb.js +1 -1
- package/ai/stigmer/agentic/workflowexecution/v1/io_pb.js.map +1 -1
- package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.d.ts +6 -0
- package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.js +7 -1
- package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.js.map +1 -1
- package/ai/stigmer/iam/v1/enum_pb.d.ts +31 -2
- package/ai/stigmer/iam/v1/enum_pb.js +30 -1
- package/ai/stigmer/iam/v1/enum_pb.js.map +1 -1
- package/ai/stigmer/platform/v1/server_info_connect.d.ts +6 -4
- package/ai/stigmer/platform/v1/server_info_connect.js +6 -4
- package/ai/stigmer/platform/v1/server_info_connect.js.map +1 -1
- package/ai/stigmer/platform/v1/server_info_pb.d.ts +53 -4
- package/ai/stigmer/platform/v1/server_info_pb.js +7 -2
- package/ai/stigmer/platform/v1/server_info_pb.js.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ChannelConversationCommandController operates a conversation's
|
|
3
|
+
* participation state: staff replies, takeover and handback of the control
|
|
4
|
+
* token, attention management, and the agent's escalation ingest.
|
|
5
|
+
*
|
|
6
|
+
* @internal
|
|
7
|
+
* channel-conversations DD-003 D-f (takeOver/handBack), DD-008 D-d
|
|
8
|
+
* (escalate), DD-009 D-a (reply), DD-010 D-b (the permission map). Two
|
|
9
|
+
* audiences on one controller, split per method: the four human-facing
|
|
10
|
+
* commands authorize declaratively on the channel with can_participate
|
|
11
|
+
* (participants are org humans who may speak to the channel's customers
|
|
12
|
+
* as the business — NOT channel configurators); escalate is agent-audience
|
|
13
|
+
* only, session-bound, with identity derived server-side. Every state
|
|
14
|
+
* transition funnels through the single participation writer (DD-003 D-c)
|
|
15
|
+
* — CAS-guarded, one winner under concurrent takeover. Cloud-first
|
|
16
|
+
* runtime: the OSS edition refuses every command FAILED_PRECONDITION (the
|
|
17
|
+
* sendMessage posture). Never hangs, never lies.
|
|
18
|
+
*
|
|
19
|
+
* @generated from service ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController
|
|
20
|
+
*/
|
|
21
|
+
export declare const ChannelConversationCommandController: {
|
|
22
|
+
readonly typeName: "ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController";
|
|
23
|
+
readonly methods: {
|
|
24
|
+
/**
|
|
25
|
+
* Reply to a conversation as the business, through the same number the
|
|
26
|
+
* agent serves.
|
|
27
|
+
*
|
|
28
|
+
* The message is durably recorded and attempted inline; the outcome
|
|
29
|
+
* reports the truth of the attempt. A staff reply on an agent-held
|
|
30
|
+
* conversation is an implicit takeover: the agent goes quiet until
|
|
31
|
+
* handBack. Replying requires an existing conversation — the customer
|
|
32
|
+
* must have written first; an unknown conversation answers NOT_FOUND.
|
|
33
|
+
*
|
|
34
|
+
* @internal
|
|
35
|
+
* channel-conversations DD-009: rides the outbound lane with the
|
|
36
|
+
* participant origin (amended by T03 Sitting 1's A1 — operator cannot
|
|
37
|
+
* distinguish a staff reply from a console cold-send, so the cap
|
|
38
|
+
* predicate would have nothing to key on), recipient derived from the
|
|
39
|
+
* conversation key (never an argument — the origin trap D-a dissolves),
|
|
40
|
+
* exempt from the proactive caps and the proactive consent lever
|
|
41
|
+
* (D-b/D-c: reply traffic inside the open service window; the authority
|
|
42
|
+
* bar is the control). The existing-conversation precondition is T03
|
|
43
|
+
* Sitting 2's A8, making D-c's "a customer who already wrote to us"
|
|
44
|
+
* literal: without it, this lane would be an uncapped, lever-free
|
|
45
|
+
* cold-send reachable below the sendMessage authority bar. The
|
|
46
|
+
* implicit-takeover flip orders before-or-with the send (T03).
|
|
47
|
+
*
|
|
48
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.reply
|
|
49
|
+
*/
|
|
50
|
+
readonly reply: {
|
|
51
|
+
readonly name: "reply";
|
|
52
|
+
readonly I: any;
|
|
53
|
+
readonly O: any;
|
|
54
|
+
readonly kind: any;
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Take over a conversation: the agent goes quiet until handBack.
|
|
58
|
+
*
|
|
59
|
+
* Taking over also clears the needs-attention flag — the human arriving
|
|
60
|
+
* is the answer to an escalation.
|
|
61
|
+
*
|
|
62
|
+
* @internal
|
|
63
|
+
* channel-conversations DD-005 (the suppression this arms), DD-007 D-f
|
|
64
|
+
* (CAS WHERE control='agent'; two concurrent attempts resolve to one
|
|
65
|
+
* winner, the loser receives the fresh state), DD-008 D-f (attention
|
|
66
|
+
* cleared on takeover).
|
|
67
|
+
*
|
|
68
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.takeOver
|
|
69
|
+
*/
|
|
70
|
+
readonly takeOver: {
|
|
71
|
+
readonly name: "takeOver";
|
|
72
|
+
readonly I: any;
|
|
73
|
+
readonly O: any;
|
|
74
|
+
readonly kind: any;
|
|
75
|
+
};
|
|
76
|
+
/**
|
|
77
|
+
* Hand a conversation back to the agent, restoring automatic replies.
|
|
78
|
+
*
|
|
79
|
+
* The agent re-enters with the conversation context it missed while the
|
|
80
|
+
* human held control.
|
|
81
|
+
*
|
|
82
|
+
* @internal
|
|
83
|
+
* channel-conversations DD-007: CAS WHERE control='human'; any holder
|
|
84
|
+
* of can_participate may hand back, not only the takeover holder (v1
|
|
85
|
+
* single attention pool). Handback never touches the attention flag
|
|
86
|
+
* (DD-002 D-a #4). The missed-context digest is composed lazily at the
|
|
87
|
+
* next turn from the agent_witnessed_through watermark, not here.
|
|
88
|
+
*
|
|
89
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.handBack
|
|
90
|
+
*/
|
|
91
|
+
readonly handBack: {
|
|
92
|
+
readonly name: "handBack";
|
|
93
|
+
readonly I: any;
|
|
94
|
+
readonly O: any;
|
|
95
|
+
readonly kind: any;
|
|
96
|
+
};
|
|
97
|
+
/**
|
|
98
|
+
* Clear a conversation's needs-attention flag without taking it over.
|
|
99
|
+
*
|
|
100
|
+
* The false-alarm dismissal: an escalation that needs no reply is
|
|
101
|
+
* cleared in place, never via a take-over-and-hand-back dance.
|
|
102
|
+
*
|
|
103
|
+
* @internal
|
|
104
|
+
* channel-conversations DD-008 D-f. Control is untouched; the clear is
|
|
105
|
+
* recorded on the conversation's event history through the
|
|
106
|
+
* participation writer.
|
|
107
|
+
*
|
|
108
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.clearAttention
|
|
109
|
+
*/
|
|
110
|
+
readonly clearAttention: {
|
|
111
|
+
readonly name: "clearAttention";
|
|
112
|
+
readonly I: any;
|
|
113
|
+
readonly O: any;
|
|
114
|
+
readonly kind: any;
|
|
115
|
+
};
|
|
116
|
+
/**
|
|
117
|
+
* Flag this conversation for human attention.
|
|
118
|
+
*
|
|
119
|
+
* Non-blocking: the agent keeps serving while the flag summons humans.
|
|
120
|
+
* Repeated escalation is harmless; the latest reason wins.
|
|
121
|
+
*
|
|
122
|
+
* @internal
|
|
123
|
+
* channel-conversations DD-008: agent-audience only — session-bound
|
|
124
|
+
* sandbox tokens; the conversation identity derives server-side from
|
|
125
|
+
* the session's channel labels (never caller-supplied, the DD-003
|
|
126
|
+
* identity doctrine), so the input carries only the reason. Appends an
|
|
127
|
+
* internal-lane escalation event and updates the row projection through
|
|
128
|
+
* the participation writer, idempotently. Approval-free by construction
|
|
129
|
+
* (unattended surfaces skip gated tools — a gated escalation would
|
|
130
|
+
* never fire). Cloud-first runtime; OSS refuses FAILED_PRECONDITION.
|
|
131
|
+
*
|
|
132
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.escalate
|
|
133
|
+
*/
|
|
134
|
+
readonly escalate: {
|
|
135
|
+
readonly name: "escalate";
|
|
136
|
+
readonly I: any;
|
|
137
|
+
readonly O: any;
|
|
138
|
+
readonly kind: any;
|
|
139
|
+
};
|
|
140
|
+
};
|
|
141
|
+
};
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
// @generated by protoc-gen-connect-es v1.6.1 with parameter "target=ts,import_extension=js"
|
|
2
|
+
// @generated from file ai/stigmer/agentic/agentchannel/v1/conversation_command.proto (package ai.stigmer.agentic.agentchannel.v1, syntax proto3)
|
|
3
|
+
/* eslint-disable */
|
|
4
|
+
// @ts-nocheck
|
|
5
|
+
import { ChannelConversation, ConversationControlInput, EscalateConversationInput, ReplyToConversationInput } from "./conversation_io_pbjs";
|
|
6
|
+
import { SendChannelMessageOutput } from "./message_io_pbjs";
|
|
7
|
+
import { MethodKind } from "@bufbuild/protobuf";
|
|
8
|
+
/**
|
|
9
|
+
* ChannelConversationCommandController operates a conversation's
|
|
10
|
+
* participation state: staff replies, takeover and handback of the control
|
|
11
|
+
* token, attention management, and the agent's escalation ingest.
|
|
12
|
+
*
|
|
13
|
+
* @internal
|
|
14
|
+
* channel-conversations DD-003 D-f (takeOver/handBack), DD-008 D-d
|
|
15
|
+
* (escalate), DD-009 D-a (reply), DD-010 D-b (the permission map). Two
|
|
16
|
+
* audiences on one controller, split per method: the four human-facing
|
|
17
|
+
* commands authorize declaratively on the channel with can_participate
|
|
18
|
+
* (participants are org humans who may speak to the channel's customers
|
|
19
|
+
* as the business — NOT channel configurators); escalate is agent-audience
|
|
20
|
+
* only, session-bound, with identity derived server-side. Every state
|
|
21
|
+
* transition funnels through the single participation writer (DD-003 D-c)
|
|
22
|
+
* — CAS-guarded, one winner under concurrent takeover. Cloud-first
|
|
23
|
+
* runtime: the OSS edition refuses every command FAILED_PRECONDITION (the
|
|
24
|
+
* sendMessage posture). Never hangs, never lies.
|
|
25
|
+
*
|
|
26
|
+
* @generated from service ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController
|
|
27
|
+
*/
|
|
28
|
+
export const ChannelConversationCommandController = {
|
|
29
|
+
typeName: "ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController",
|
|
30
|
+
methods: {
|
|
31
|
+
/**
|
|
32
|
+
* Reply to a conversation as the business, through the same number the
|
|
33
|
+
* agent serves.
|
|
34
|
+
*
|
|
35
|
+
* The message is durably recorded and attempted inline; the outcome
|
|
36
|
+
* reports the truth of the attempt. A staff reply on an agent-held
|
|
37
|
+
* conversation is an implicit takeover: the agent goes quiet until
|
|
38
|
+
* handBack. Replying requires an existing conversation — the customer
|
|
39
|
+
* must have written first; an unknown conversation answers NOT_FOUND.
|
|
40
|
+
*
|
|
41
|
+
* @internal
|
|
42
|
+
* channel-conversations DD-009: rides the outbound lane with the
|
|
43
|
+
* participant origin (amended by T03 Sitting 1's A1 — operator cannot
|
|
44
|
+
* distinguish a staff reply from a console cold-send, so the cap
|
|
45
|
+
* predicate would have nothing to key on), recipient derived from the
|
|
46
|
+
* conversation key (never an argument — the origin trap D-a dissolves),
|
|
47
|
+
* exempt from the proactive caps and the proactive consent lever
|
|
48
|
+
* (D-b/D-c: reply traffic inside the open service window; the authority
|
|
49
|
+
* bar is the control). The existing-conversation precondition is T03
|
|
50
|
+
* Sitting 2's A8, making D-c's "a customer who already wrote to us"
|
|
51
|
+
* literal: without it, this lane would be an uncapped, lever-free
|
|
52
|
+
* cold-send reachable below the sendMessage authority bar. The
|
|
53
|
+
* implicit-takeover flip orders before-or-with the send (T03).
|
|
54
|
+
*
|
|
55
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.reply
|
|
56
|
+
*/
|
|
57
|
+
reply: {
|
|
58
|
+
name: "reply",
|
|
59
|
+
I: ReplyToConversationInput,
|
|
60
|
+
O: SendChannelMessageOutput,
|
|
61
|
+
kind: MethodKind.Unary,
|
|
62
|
+
},
|
|
63
|
+
/**
|
|
64
|
+
* Take over a conversation: the agent goes quiet until handBack.
|
|
65
|
+
*
|
|
66
|
+
* Taking over also clears the needs-attention flag — the human arriving
|
|
67
|
+
* is the answer to an escalation.
|
|
68
|
+
*
|
|
69
|
+
* @internal
|
|
70
|
+
* channel-conversations DD-005 (the suppression this arms), DD-007 D-f
|
|
71
|
+
* (CAS WHERE control='agent'; two concurrent attempts resolve to one
|
|
72
|
+
* winner, the loser receives the fresh state), DD-008 D-f (attention
|
|
73
|
+
* cleared on takeover).
|
|
74
|
+
*
|
|
75
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.takeOver
|
|
76
|
+
*/
|
|
77
|
+
takeOver: {
|
|
78
|
+
name: "takeOver",
|
|
79
|
+
I: ConversationControlInput,
|
|
80
|
+
O: ChannelConversation,
|
|
81
|
+
kind: MethodKind.Unary,
|
|
82
|
+
},
|
|
83
|
+
/**
|
|
84
|
+
* Hand a conversation back to the agent, restoring automatic replies.
|
|
85
|
+
*
|
|
86
|
+
* The agent re-enters with the conversation context it missed while the
|
|
87
|
+
* human held control.
|
|
88
|
+
*
|
|
89
|
+
* @internal
|
|
90
|
+
* channel-conversations DD-007: CAS WHERE control='human'; any holder
|
|
91
|
+
* of can_participate may hand back, not only the takeover holder (v1
|
|
92
|
+
* single attention pool). Handback never touches the attention flag
|
|
93
|
+
* (DD-002 D-a #4). The missed-context digest is composed lazily at the
|
|
94
|
+
* next turn from the agent_witnessed_through watermark, not here.
|
|
95
|
+
*
|
|
96
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.handBack
|
|
97
|
+
*/
|
|
98
|
+
handBack: {
|
|
99
|
+
name: "handBack",
|
|
100
|
+
I: ConversationControlInput,
|
|
101
|
+
O: ChannelConversation,
|
|
102
|
+
kind: MethodKind.Unary,
|
|
103
|
+
},
|
|
104
|
+
/**
|
|
105
|
+
* Clear a conversation's needs-attention flag without taking it over.
|
|
106
|
+
*
|
|
107
|
+
* The false-alarm dismissal: an escalation that needs no reply is
|
|
108
|
+
* cleared in place, never via a take-over-and-hand-back dance.
|
|
109
|
+
*
|
|
110
|
+
* @internal
|
|
111
|
+
* channel-conversations DD-008 D-f. Control is untouched; the clear is
|
|
112
|
+
* recorded on the conversation's event history through the
|
|
113
|
+
* participation writer.
|
|
114
|
+
*
|
|
115
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.clearAttention
|
|
116
|
+
*/
|
|
117
|
+
clearAttention: {
|
|
118
|
+
name: "clearAttention",
|
|
119
|
+
I: ConversationControlInput,
|
|
120
|
+
O: ChannelConversation,
|
|
121
|
+
kind: MethodKind.Unary,
|
|
122
|
+
},
|
|
123
|
+
/**
|
|
124
|
+
* Flag this conversation for human attention.
|
|
125
|
+
*
|
|
126
|
+
* Non-blocking: the agent keeps serving while the flag summons humans.
|
|
127
|
+
* Repeated escalation is harmless; the latest reason wins.
|
|
128
|
+
*
|
|
129
|
+
* @internal
|
|
130
|
+
* channel-conversations DD-008: agent-audience only — session-bound
|
|
131
|
+
* sandbox tokens; the conversation identity derives server-side from
|
|
132
|
+
* the session's channel labels (never caller-supplied, the DD-003
|
|
133
|
+
* identity doctrine), so the input carries only the reason. Appends an
|
|
134
|
+
* internal-lane escalation event and updates the row projection through
|
|
135
|
+
* the participation writer, idempotently. Approval-free by construction
|
|
136
|
+
* (unattended surfaces skip gated tools — a gated escalation would
|
|
137
|
+
* never fire). Cloud-first runtime; OSS refuses FAILED_PRECONDITION.
|
|
138
|
+
*
|
|
139
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.escalate
|
|
140
|
+
*/
|
|
141
|
+
escalate: {
|
|
142
|
+
name: "escalate",
|
|
143
|
+
I: EscalateConversationInput,
|
|
144
|
+
O: ChannelConversation,
|
|
145
|
+
kind: MethodKind.Unary,
|
|
146
|
+
},
|
|
147
|
+
}
|
|
148
|
+
};
|
|
149
|
+
//# sourceMappingURL=conversation_command_connect.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"conversation_command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentchannel/v1/conversation_command_connect.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,iJAAiJ;AACjJ,oBAAoB;AACpB,cAAc;AAEd,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC5I,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,QAAQ,EAAE,yEAAyE;IACnF,OAAO,EAAE;QACP;;;;;;;;;;;;;;;;;;;;;;;;;WAyBG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,wBAAwB;YAC3B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;WAaG;QACH,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU;YAChB,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,mBAAmB;YACtB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;WAcG;QACH,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU;YAChB,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,mBAAmB;YACtB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;WAYG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,mBAAmB;YACtB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;WAiBG;QACH,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU;YAChB,CAAC,EAAE,yBAAyB;YAC5B,CAAC,EAAE,mBAAmB;YACtB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
|
|
2
|
+
import type { ChannelConversationSchema, ConversationControlInputSchema, EscalateConversationInputSchema, ReplyToConversationInputSchema } from "./conversation_io_pb.js";
|
|
3
|
+
import type { SendChannelMessageOutputSchema } from "./message_io_pb.js";
|
|
4
|
+
/**
|
|
5
|
+
* Describes the file ai/stigmer/agentic/agentchannel/v1/conversation_command.proto.
|
|
6
|
+
*/
|
|
7
|
+
export declare const file_ai_stigmer_agentic_agentchannel_v1_conversation_command: GenFile;
|
|
8
|
+
/**
|
|
9
|
+
* ChannelConversationCommandController operates a conversation's
|
|
10
|
+
* participation state: staff replies, takeover and handback of the control
|
|
11
|
+
* token, attention management, and the agent's escalation ingest.
|
|
12
|
+
*
|
|
13
|
+
* @internal
|
|
14
|
+
* channel-conversations DD-003 D-f (takeOver/handBack), DD-008 D-d
|
|
15
|
+
* (escalate), DD-009 D-a (reply), DD-010 D-b (the permission map). Two
|
|
16
|
+
* audiences on one controller, split per method: the four human-facing
|
|
17
|
+
* commands authorize declaratively on the channel with can_participate
|
|
18
|
+
* (participants are org humans who may speak to the channel's customers
|
|
19
|
+
* as the business — NOT channel configurators); escalate is agent-audience
|
|
20
|
+
* only, session-bound, with identity derived server-side. Every state
|
|
21
|
+
* transition funnels through the single participation writer (DD-003 D-c)
|
|
22
|
+
* — CAS-guarded, one winner under concurrent takeover. Cloud-first
|
|
23
|
+
* runtime: the OSS edition refuses every command FAILED_PRECONDITION (the
|
|
24
|
+
* sendMessage posture). Never hangs, never lies.
|
|
25
|
+
*
|
|
26
|
+
* @generated from service ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController
|
|
27
|
+
*/
|
|
28
|
+
export declare const ChannelConversationCommandController: GenService<{
|
|
29
|
+
/**
|
|
30
|
+
* Reply to a conversation as the business, through the same number the
|
|
31
|
+
* agent serves.
|
|
32
|
+
*
|
|
33
|
+
* The message is durably recorded and attempted inline; the outcome
|
|
34
|
+
* reports the truth of the attempt. A staff reply on an agent-held
|
|
35
|
+
* conversation is an implicit takeover: the agent goes quiet until
|
|
36
|
+
* handBack. Replying requires an existing conversation — the customer
|
|
37
|
+
* must have written first; an unknown conversation answers NOT_FOUND.
|
|
38
|
+
*
|
|
39
|
+
* @internal
|
|
40
|
+
* channel-conversations DD-009: rides the outbound lane with the
|
|
41
|
+
* participant origin (amended by T03 Sitting 1's A1 — operator cannot
|
|
42
|
+
* distinguish a staff reply from a console cold-send, so the cap
|
|
43
|
+
* predicate would have nothing to key on), recipient derived from the
|
|
44
|
+
* conversation key (never an argument — the origin trap D-a dissolves),
|
|
45
|
+
* exempt from the proactive caps and the proactive consent lever
|
|
46
|
+
* (D-b/D-c: reply traffic inside the open service window; the authority
|
|
47
|
+
* bar is the control). The existing-conversation precondition is T03
|
|
48
|
+
* Sitting 2's A8, making D-c's "a customer who already wrote to us"
|
|
49
|
+
* literal: without it, this lane would be an uncapped, lever-free
|
|
50
|
+
* cold-send reachable below the sendMessage authority bar. The
|
|
51
|
+
* implicit-takeover flip orders before-or-with the send (T03).
|
|
52
|
+
*
|
|
53
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.reply
|
|
54
|
+
*/
|
|
55
|
+
reply: {
|
|
56
|
+
methodKind: "unary";
|
|
57
|
+
input: typeof ReplyToConversationInputSchema;
|
|
58
|
+
output: typeof SendChannelMessageOutputSchema;
|
|
59
|
+
};
|
|
60
|
+
/**
|
|
61
|
+
* Take over a conversation: the agent goes quiet until handBack.
|
|
62
|
+
*
|
|
63
|
+
* Taking over also clears the needs-attention flag — the human arriving
|
|
64
|
+
* is the answer to an escalation.
|
|
65
|
+
*
|
|
66
|
+
* @internal
|
|
67
|
+
* channel-conversations DD-005 (the suppression this arms), DD-007 D-f
|
|
68
|
+
* (CAS WHERE control='agent'; two concurrent attempts resolve to one
|
|
69
|
+
* winner, the loser receives the fresh state), DD-008 D-f (attention
|
|
70
|
+
* cleared on takeover).
|
|
71
|
+
*
|
|
72
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.takeOver
|
|
73
|
+
*/
|
|
74
|
+
takeOver: {
|
|
75
|
+
methodKind: "unary";
|
|
76
|
+
input: typeof ConversationControlInputSchema;
|
|
77
|
+
output: typeof ChannelConversationSchema;
|
|
78
|
+
};
|
|
79
|
+
/**
|
|
80
|
+
* Hand a conversation back to the agent, restoring automatic replies.
|
|
81
|
+
*
|
|
82
|
+
* The agent re-enters with the conversation context it missed while the
|
|
83
|
+
* human held control.
|
|
84
|
+
*
|
|
85
|
+
* @internal
|
|
86
|
+
* channel-conversations DD-007: CAS WHERE control='human'; any holder
|
|
87
|
+
* of can_participate may hand back, not only the takeover holder (v1
|
|
88
|
+
* single attention pool). Handback never touches the attention flag
|
|
89
|
+
* (DD-002 D-a #4). The missed-context digest is composed lazily at the
|
|
90
|
+
* next turn from the agent_witnessed_through watermark, not here.
|
|
91
|
+
*
|
|
92
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.handBack
|
|
93
|
+
*/
|
|
94
|
+
handBack: {
|
|
95
|
+
methodKind: "unary";
|
|
96
|
+
input: typeof ConversationControlInputSchema;
|
|
97
|
+
output: typeof ChannelConversationSchema;
|
|
98
|
+
};
|
|
99
|
+
/**
|
|
100
|
+
* Clear a conversation's needs-attention flag without taking it over.
|
|
101
|
+
*
|
|
102
|
+
* The false-alarm dismissal: an escalation that needs no reply is
|
|
103
|
+
* cleared in place, never via a take-over-and-hand-back dance.
|
|
104
|
+
*
|
|
105
|
+
* @internal
|
|
106
|
+
* channel-conversations DD-008 D-f. Control is untouched; the clear is
|
|
107
|
+
* recorded on the conversation's event history through the
|
|
108
|
+
* participation writer.
|
|
109
|
+
*
|
|
110
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.clearAttention
|
|
111
|
+
*/
|
|
112
|
+
clearAttention: {
|
|
113
|
+
methodKind: "unary";
|
|
114
|
+
input: typeof ConversationControlInputSchema;
|
|
115
|
+
output: typeof ChannelConversationSchema;
|
|
116
|
+
};
|
|
117
|
+
/**
|
|
118
|
+
* Flag this conversation for human attention.
|
|
119
|
+
*
|
|
120
|
+
* Non-blocking: the agent keeps serving while the flag summons humans.
|
|
121
|
+
* Repeated escalation is harmless; the latest reason wins.
|
|
122
|
+
*
|
|
123
|
+
* @internal
|
|
124
|
+
* channel-conversations DD-008: agent-audience only — session-bound
|
|
125
|
+
* sandbox tokens; the conversation identity derives server-side from
|
|
126
|
+
* the session's channel labels (never caller-supplied, the DD-003
|
|
127
|
+
* identity doctrine), so the input carries only the reason. Appends an
|
|
128
|
+
* internal-lane escalation event and updates the row projection through
|
|
129
|
+
* the participation writer, idempotently. Approval-free by construction
|
|
130
|
+
* (unattended surfaces skip gated tools — a gated escalation would
|
|
131
|
+
* never fire). Cloud-first runtime; OSS refuses FAILED_PRECONDITION.
|
|
132
|
+
*
|
|
133
|
+
* @generated from rpc ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController.escalate
|
|
134
|
+
*/
|
|
135
|
+
escalate: {
|
|
136
|
+
methodKind: "unary";
|
|
137
|
+
input: typeof EscalateConversationInputSchema;
|
|
138
|
+
output: typeof ChannelConversationSchema;
|
|
139
|
+
};
|
|
140
|
+
}>;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
|
|
2
|
+
// @generated from file ai/stigmer/agentic/agentchannel/v1/conversation_command.proto (package ai.stigmer.agentic.agentchannel.v1, syntax proto3)
|
|
3
|
+
/* eslint-disable */
|
|
4
|
+
import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
|
|
5
|
+
import { file_ai_stigmer_agentic_agentchannel_v1_conversation_io } from "./conversation_io_pb.js";
|
|
6
|
+
import { file_ai_stigmer_agentic_agentchannel_v1_message_io } from "./message_io_pb.js";
|
|
7
|
+
import { file_ai_stigmer_commons_apiresource_rpc_service_options } from "../../../commons/apiresource/rpc_service_options_pb.js";
|
|
8
|
+
import { file_ai_stigmer_commons_rpc_method_options } from "../../../commons/rpc/method_options_pb.js";
|
|
9
|
+
/**
|
|
10
|
+
* Describes the file ai/stigmer/agentic/agentchannel/v1/conversation_command.proto.
|
|
11
|
+
*/
|
|
12
|
+
export const file_ai_stigmer_agentic_agentchannel_v1_conversation_command = /*@__PURE__*/ fileDesc("Cj1haS9zdGlnbWVyL2FnZW50aWMvYWdlbnRjaGFubmVsL3YxL2NvbnZlcnNhdGlvbl9jb21tYW5kLnByb3RvEiJhaS5zdGlnbWVyLmFnZW50aWMuYWdlbnRjaGFubmVsLnYxMrcICiRDaGFubmVsQ29udmVyc2F0aW9uQ29tbWFuZENvbnRyb2xsZXIS3QEKBXJlcGx5EjwuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50Y2hhbm5lbC52MS5SZXBseVRvQ29udmVyc2F0aW9uSW5wdXQaPC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRjaGFubmVsLnYxLlNlbmRDaGFubmVsTWVzc2FnZU91dHB1dCJYwrgYVAgkEC8iEGFnZW50X2NoYW5uZWxfaWQqPHVuYXV0aG9yaXplZCB0byBwYXJ0aWNpcGF0ZSBpbiBjb252ZXJzYXRpb25zIG9uIHRoaXMgY2hhbm5lbBLbAQoIdGFrZU92ZXISPC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRjaGFubmVsLnYxLkNvbnZlcnNhdGlvbkNvbnRyb2xJbnB1dBo3LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGNoYW5uZWwudjEuQ2hhbm5lbENvbnZlcnNhdGlvbiJYwrgYVAgkEC8iEGFnZW50X2NoYW5uZWxfaWQqPHVuYXV0aG9yaXplZCB0byBwYXJ0aWNpcGF0ZSBpbiBjb252ZXJzYXRpb25zIG9uIHRoaXMgY2hhbm5lbBLbAQoIaGFuZEJhY2sSPC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRjaGFubmVsLnYxLkNvbnZlcnNhdGlvbkNvbnRyb2xJbnB1dBo3LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGNoYW5uZWwudjEuQ2hhbm5lbENvbnZlcnNhdGlvbiJYwrgYVAgkEC8iEGFnZW50X2NoYW5uZWxfaWQqPHVuYXV0aG9yaXplZCB0byBwYXJ0aWNpcGF0ZSBpbiBjb252ZXJzYXRpb25zIG9uIHRoaXMgY2hhbm5lbBLhAQoOY2xlYXJBdHRlbnRpb24SPC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRjaGFubmVsLnYxLkNvbnZlcnNhdGlvbkNvbnRyb2xJbnB1dBo3LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGNoYW5uZWwudjEuQ2hhbm5lbENvbnZlcnNhdGlvbiJYwrgYVAgkEC8iEGFnZW50X2NoYW5uZWxfaWQqPHVuYXV0aG9yaXplZCB0byBwYXJ0aWNpcGF0ZSBpbiBjb252ZXJzYXRpb25zIG9uIHRoaXMgY2hhbm5lbBKIAQoIZXNjYWxhdGUSPS5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRjaGFubmVsLnYxLkVzY2FsYXRlQ29udmVyc2F0aW9uSW5wdXQaNy5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRjaGFubmVsLnYxLkNoYW5uZWxDb252ZXJzYXRpb24iBNC4GAEaBKD/Ky9iBnByb3RvMw", [file_ai_stigmer_agentic_agentchannel_v1_conversation_io, file_ai_stigmer_agentic_agentchannel_v1_message_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
|
|
13
|
+
/**
|
|
14
|
+
* ChannelConversationCommandController operates a conversation's
|
|
15
|
+
* participation state: staff replies, takeover and handback of the control
|
|
16
|
+
* token, attention management, and the agent's escalation ingest.
|
|
17
|
+
*
|
|
18
|
+
* @internal
|
|
19
|
+
* channel-conversations DD-003 D-f (takeOver/handBack), DD-008 D-d
|
|
20
|
+
* (escalate), DD-009 D-a (reply), DD-010 D-b (the permission map). Two
|
|
21
|
+
* audiences on one controller, split per method: the four human-facing
|
|
22
|
+
* commands authorize declaratively on the channel with can_participate
|
|
23
|
+
* (participants are org humans who may speak to the channel's customers
|
|
24
|
+
* as the business — NOT channel configurators); escalate is agent-audience
|
|
25
|
+
* only, session-bound, with identity derived server-side. Every state
|
|
26
|
+
* transition funnels through the single participation writer (DD-003 D-c)
|
|
27
|
+
* — CAS-guarded, one winner under concurrent takeover. Cloud-first
|
|
28
|
+
* runtime: the OSS edition refuses every command FAILED_PRECONDITION (the
|
|
29
|
+
* sendMessage posture). Never hangs, never lies.
|
|
30
|
+
*
|
|
31
|
+
* @generated from service ai.stigmer.agentic.agentchannel.v1.ChannelConversationCommandController
|
|
32
|
+
*/
|
|
33
|
+
export const ChannelConversationCommandController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_agentic_agentchannel_v1_conversation_command, 0);
|
|
34
|
+
//# sourceMappingURL=conversation_command_pb.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"conversation_command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentchannel/v1/conversation_command_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,iJAAiJ;AACjJ,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uDAAuD,EAAE,MAAM,yBAAyB,CAAC;AAElG,OAAO,EAAE,kDAAkD,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,4DAA4D,GAAY,aAAa,CAChG,QAAQ,CAAC,ojDAAojD,EAAE,CAAC,uDAAuD,EAAE,kDAAkD,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAErxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAgH5C,aAAa,CAChB,WAAW,CAAC,4DAA4D,EAAE,CAAC,CAAC,CAAC"}
|