@stigmer/protos 3.6.0 → 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.
Files changed (79) hide show
  1. package/ai/stigmer/agentic/agentchannel/v1/conversation_command_connect.d.ts +141 -0
  2. package/ai/stigmer/agentic/agentchannel/v1/conversation_command_connect.js +149 -0
  3. package/ai/stigmer/agentic/agentchannel/v1/conversation_command_connect.js.map +1 -0
  4. package/ai/stigmer/agentic/agentchannel/v1/conversation_command_pb.d.ts +140 -0
  5. package/ai/stigmer/agentic/agentchannel/v1/conversation_command_pb.js +34 -0
  6. package/ai/stigmer/agentic/agentchannel/v1/conversation_command_pb.js.map +1 -0
  7. package/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb.d.ts +541 -0
  8. package/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb.js +181 -0
  9. package/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb.js.map +1 -0
  10. package/ai/stigmer/agentic/agentchannel/v1/conversation_query_connect.d.ts +69 -0
  11. package/ai/stigmer/agentic/agentchannel/v1/conversation_query_connect.js +76 -0
  12. package/ai/stigmer/agentic/agentchannel/v1/conversation_query_connect.js.map +1 -0
  13. package/ai/stigmer/agentic/agentchannel/v1/conversation_query_pb.d.ts +70 -0
  14. package/ai/stigmer/agentic/agentchannel/v1/conversation_query_pb.js +30 -0
  15. package/ai/stigmer/agentic/agentchannel/v1/conversation_query_pb.js.map +1 -0
  16. package/ai/stigmer/agentic/agentchannel/v1/delivery_pb.d.ts +36 -2
  17. package/ai/stigmer/agentic/agentchannel/v1/delivery_pb.js +18 -2
  18. package/ai/stigmer/agentic/agentchannel/v1/delivery_pb.js.map +1 -1
  19. package/ai/stigmer/agentic/agentchannel/v1/outbound_pb.d.ts +38 -4
  20. package/ai/stigmer/agentic/agentchannel/v1/outbound_pb.js +38 -4
  21. package/ai/stigmer/agentic/agentchannel/v1/outbound_pb.js.map +1 -1
  22. package/ai/stigmer/agentic/agentchannel/v1/spec_pb.d.ts +25 -0
  23. package/ai/stigmer/agentic/agentchannel/v1/spec_pb.js +2 -1
  24. package/ai/stigmer/agentic/agentchannel/v1/spec_pb.js.map +1 -1
  25. package/ai/stigmer/agentic/agentexecution/v1/api_pb.d.ts +5 -1
  26. package/ai/stigmer/agentic/agentexecution/v1/api_pb.js.map +1 -1
  27. package/ai/stigmer/agentic/agentexecution/v1/enum_pb.d.ts +66 -0
  28. package/ai/stigmer/agentic/agentexecution/v1/enum_pb.js +81 -14
  29. package/ai/stigmer/agentic/agentexecution/v1/enum_pb.js.map +1 -1
  30. package/ai/stigmer/agentic/agentexecution/v1/invocation_pb.d.ts +210 -0
  31. package/ai/stigmer/agentic/agentexecution/v1/invocation_pb.js +25 -0
  32. package/ai/stigmer/agentic/agentexecution/v1/invocation_pb.js.map +1 -0
  33. package/ai/stigmer/agentic/agentexecution/v1/spec_pb.d.ts +13 -1
  34. package/ai/stigmer/agentic/agentexecution/v1/spec_pb.js +1 -1
  35. package/ai/stigmer/agentic/agentexecution/v1/spec_pb.js.map +1 -1
  36. package/ai/stigmer/agentic/agentexecution/v1/usage_pb.d.ts +33 -1
  37. package/ai/stigmer/agentic/agentexecution/v1/usage_pb.js +2 -1
  38. package/ai/stigmer/agentic/agentexecution/v1/usage_pb.js.map +1 -1
  39. package/ai/stigmer/agentic/agentshare/v1/spec_pb.d.ts +27 -0
  40. package/ai/stigmer/agentic/agentshare/v1/spec_pb.js +2 -1
  41. package/ai/stigmer/agentic/agentshare/v1/spec_pb.js.map +1 -1
  42. package/ai/stigmer/agentic/schedule/v1/command_connect.d.ts +35 -21
  43. package/ai/stigmer/agentic/schedule/v1/command_connect.js +37 -23
  44. package/ai/stigmer/agentic/schedule/v1/command_connect.js.map +1 -1
  45. package/ai/stigmer/agentic/schedule/v1/command_pb.d.ts +37 -23
  46. package/ai/stigmer/agentic/schedule/v1/command_pb.js +1 -1
  47. package/ai/stigmer/agentic/schedule/v1/command_pb.js.map +1 -1
  48. package/ai/stigmer/agentic/schedule/v1/io_pb.d.ts +266 -1
  49. package/ai/stigmer/agentic/schedule/v1/io_pb.js +120 -2
  50. package/ai/stigmer/agentic/schedule/v1/io_pb.js.map +1 -1
  51. package/ai/stigmer/agentic/schedule/v1/query_connect.d.ts +26 -0
  52. package/ai/stigmer/agentic/schedule/v1/query_connect.js +27 -1
  53. package/ai/stigmer/agentic/schedule/v1/query_connect.js.map +1 -1
  54. package/ai/stigmer/agentic/schedule/v1/query_pb.d.ts +26 -1
  55. package/ai/stigmer/agentic/schedule/v1/query_pb.js +1 -1
  56. package/ai/stigmer/agentic/schedule/v1/query_pb.js.map +1 -1
  57. package/ai/stigmer/agentic/schedule/v1/spec_pb.d.ts +30 -49
  58. package/ai/stigmer/agentic/schedule/v1/spec_pb.js +2 -8
  59. package/ai/stigmer/agentic/schedule/v1/spec_pb.js.map +1 -1
  60. package/ai/stigmer/agentic/session/v1/enum_pb.d.ts +10 -8
  61. package/ai/stigmer/agentic/session/v1/enum_pb.js +10 -8
  62. package/ai/stigmer/agentic/session/v1/enum_pb.js.map +1 -1
  63. package/ai/stigmer/agentic/session/v1/spec_pb.d.ts +7 -5
  64. package/ai/stigmer/agentic/session/v1/spec_pb.js.map +1 -1
  65. package/ai/stigmer/agentic/workflow/v1/tasks/agent_call_pb.d.ts +123 -104
  66. package/ai/stigmer/agentic/workflow/v1/tasks/agent_call_pb.js +4 -7
  67. package/ai/stigmer/agentic/workflow/v1/tasks/agent_call_pb.js.map +1 -1
  68. package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.js +1 -1
  69. package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.js.map +1 -1
  70. package/ai/stigmer/iam/v1/enum_pb.d.ts +31 -2
  71. package/ai/stigmer/iam/v1/enum_pb.js +30 -1
  72. package/ai/stigmer/iam/v1/enum_pb.js.map +1 -1
  73. package/ai/stigmer/platform/v1/server_info_connect.d.ts +6 -4
  74. package/ai/stigmer/platform/v1/server_info_connect.js +6 -4
  75. package/ai/stigmer/platform/v1/server_info_connect.js.map +1 -1
  76. package/ai/stigmer/platform/v1/server_info_pb.d.ts +53 -4
  77. package/ai/stigmer/platform/v1/server_info_pb.js +7 -2
  78. package/ai/stigmer/platform/v1/server_info_pb.js.map +1 -1
  79. 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"}