@finalai/agent-provider 0.5.0 → 0.6.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/HOSTING.md +7 -7
- package/README.md +54 -0
- package/dist/modules/channel-socket.d.mts +8 -4
- package/dist/modules/channel-socket.mjs +39 -2
- package/dist/modules/channel-socket.mjs.map +2 -2
- package/dist/modules/channel.d.mts +323 -363
- package/dist/modules/channel.mjs +60 -145
- package/dist/modules/channel.mjs.map +3 -3
- package/dist/modules/credentials.mjs.map +2 -2
- package/dist/modules/index.d.mts +0 -1
- package/dist/modules/index.mjs +0 -1
- package/dist/modules/index.mjs.map +2 -2
- package/dist/modules/local-channel-context.d.mts +10 -0
- package/dist/modules/local-channel-context.mjs +55 -0
- package/dist/modules/local-channel-context.mjs.map +7 -0
- package/dist/modules/local-channel-socket.d.mts +8 -4
- package/dist/modules/local-channel-socket.mjs +1 -13
- package/dist/modules/local-channel-socket.mjs.map +2 -2
- package/dist/modules/manifest.d.mts +92 -4
- package/dist/modules/manifest.mjs +29 -9
- package/dist/modules/manifest.mjs.map +2 -2
- package/dist/modules/room-surface.d.mts +370 -0
- package/dist/modules/room-surface.mjs +156 -0
- package/dist/modules/room-surface.mjs.map +7 -0
- package/dist/modules/sandbox/networking.mjs +1 -0
- package/dist/modules/sandbox/networking.mjs.map +2 -2
- package/dist/modules/sandbox/types.d.mts +20 -0
- package/dist/modules/sandbox/types.mjs +6 -0
- package/dist/modules/sandbox/types.mjs.map +2 -2
- package/dist/modules/semantic-events.d.mts +69 -1
- package/dist/modules/semantic-events.mjs +14 -1
- package/dist/modules/semantic-events.mjs.map +2 -2
- package/package.json +14 -9
- package/dist/modules/channel-context.d.mts +0 -106
- package/dist/modules/channel-context.mjs +0 -45
- package/dist/modules/channel-context.mjs.map +0 -7
package/dist/modules/channel.mjs
CHANGED
|
@@ -1,156 +1,71 @@
|
|
|
1
1
|
import * as z from "zod";
|
|
2
|
-
import { jsonObjectSchema
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
principalType: z.nativeEnum(ChannelPrincipalType),
|
|
11
|
-
authenticator: z.string().min(1),
|
|
12
|
-
// How the agent and the people reading its reply name the principal.
|
|
13
|
-
displayName: z.string().min(1).max(200).optional(),
|
|
14
|
-
attributes: jsonObjectSchema.default({})
|
|
2
|
+
import { jsonObjectSchema } from "./json.mjs";
|
|
3
|
+
export * from "./room-surface.mjs";
|
|
4
|
+
const personHandleSchema = z.string().min(1).brand();
|
|
5
|
+
const conversationHandleSchema = z.string().min(1).brand();
|
|
6
|
+
const principalRefSchema = z.object({
|
|
7
|
+
id: z.string().min(1),
|
|
8
|
+
tenant: z.string().min(1).optional(),
|
|
9
|
+
displayName: z.string().optional()
|
|
15
10
|
});
|
|
16
|
-
const
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
return
|
|
35
|
-
})(
|
|
36
|
-
var
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
return
|
|
40
|
-
})(
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
return Delivery2;
|
|
45
|
-
})(Delivery || {});
|
|
46
|
-
var MessageKind = /* @__PURE__ */ ((MessageKind2) => {
|
|
47
|
-
MessageKind2["Message"] = "message";
|
|
48
|
-
MessageKind2["Card"] = "card";
|
|
49
|
-
return MessageKind2;
|
|
50
|
-
})(MessageKind || {});
|
|
51
|
-
var CardKind = /* @__PURE__ */ ((CardKind2) => {
|
|
52
|
-
CardKind2["Elicitation"] = "elicitation";
|
|
53
|
-
CardKind2["Permission"] = "permission";
|
|
54
|
-
CardKind2["Notice"] = "notice";
|
|
55
|
-
return CardKind2;
|
|
56
|
-
})(CardKind || {});
|
|
57
|
-
const channelReceiveResultSchema = z.union([
|
|
58
|
-
z.object({ conversationId: z.string().min(1) }),
|
|
59
|
-
z.object({ sessionId: z.string().min(1) }),
|
|
60
|
-
z.null()
|
|
61
|
-
]);
|
|
62
|
-
const channelMessageInputSchema = z.object({
|
|
63
|
-
conversationId: z.string().min(1),
|
|
64
|
-
authorParticipantId: z.string().min(1),
|
|
65
|
-
kind: z.nativeEnum(MessageKind).default("message" /* Message */),
|
|
66
|
-
content: z.array(jsonObjectSchema).min(1),
|
|
67
|
-
clientMessageId: z.string().min(1).nullish(),
|
|
68
|
-
replyToMessageId: z.string().min(1).nullish(),
|
|
69
|
-
threadRootId: z.string().min(1).nullish(),
|
|
70
|
-
quotedMessageIds: z.array(z.string().min(1)).default([]),
|
|
71
|
-
mentionedParticipantIds: z.array(z.string().min(1)).default([])
|
|
72
|
-
});
|
|
73
|
-
var DecisionEventKind = /* @__PURE__ */ ((DecisionEventKind2) => {
|
|
74
|
-
DecisionEventKind2["Created"] = "decision.created";
|
|
75
|
-
DecisionEventKind2["Resolved"] = "decision.resolved";
|
|
76
|
-
return DecisionEventKind2;
|
|
77
|
-
})(DecisionEventKind || {});
|
|
78
|
-
var DecisionKind = /* @__PURE__ */ ((DecisionKind2) => {
|
|
79
|
-
DecisionKind2["Permission"] = "permission";
|
|
80
|
-
DecisionKind2["Elicitation"] = "elicitation";
|
|
81
|
-
return DecisionKind2;
|
|
82
|
-
})(DecisionKind || {});
|
|
83
|
-
const decisionCreatedDataSchema = z.object({
|
|
84
|
-
decisionId: z.string().min(1),
|
|
85
|
-
kind: z.nativeEnum(DecisionKind),
|
|
86
|
-
audienceParticipantIds: z.array(z.string()),
|
|
87
|
-
request: jsonValueSchema
|
|
11
|
+
const placeRefSchema = z.lazy(
|
|
12
|
+
() => z.object({
|
|
13
|
+
kind: z.string().min(1),
|
|
14
|
+
id: z.string().min(1),
|
|
15
|
+
tenant: z.string().min(1).optional(),
|
|
16
|
+
parent: placeRefSchema.optional(),
|
|
17
|
+
title: z.string().optional()
|
|
18
|
+
})
|
|
19
|
+
);
|
|
20
|
+
const originSchema = z.object({ place: placeRefSchema, ref: jsonObjectSchema.optional() });
|
|
21
|
+
var ChannelReplies = /* @__PURE__ */ ((ChannelReplies2) => {
|
|
22
|
+
ChannelReplies2["Origin"] = "origin";
|
|
23
|
+
ChannelReplies2["All"] = "all";
|
|
24
|
+
return ChannelReplies2;
|
|
25
|
+
})(ChannelReplies || {});
|
|
26
|
+
var ChannelAudience = /* @__PURE__ */ ((ChannelAudience2) => {
|
|
27
|
+
ChannelAudience2["Members"] = "members";
|
|
28
|
+
ChannelAudience2["Anyone"] = "anyone";
|
|
29
|
+
return ChannelAudience2;
|
|
30
|
+
})(ChannelAudience || {});
|
|
31
|
+
var ChannelCreate = /* @__PURE__ */ ((ChannelCreate2) => {
|
|
32
|
+
ChannelCreate2["DirectWithAgent"] = "direct-with-agent";
|
|
33
|
+
ChannelCreate2["Group"] = "group";
|
|
34
|
+
return ChannelCreate2;
|
|
35
|
+
})(ChannelCreate || {});
|
|
36
|
+
const placePolicySchema = z.object({
|
|
37
|
+
replies: z.nativeEnum(ChannelReplies),
|
|
38
|
+
audience: z.nativeEnum(ChannelAudience)
|
|
88
39
|
});
|
|
89
|
-
const
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
40
|
+
const refusalSchema = z.object({
|
|
41
|
+
refused: z.union([
|
|
42
|
+
z.literal("unlinked"),
|
|
43
|
+
z.literal("no-access"),
|
|
44
|
+
z.literal("unconnected"),
|
|
45
|
+
z.literal("not-audience")
|
|
46
|
+
]),
|
|
47
|
+
linkUrl: z.string().optional(),
|
|
48
|
+
connectUrl: z.string().optional(),
|
|
49
|
+
message: z.string()
|
|
93
50
|
});
|
|
94
|
-
const
|
|
95
|
-
|
|
96
|
-
|
|
51
|
+
const channelReceiveResultSchema = z.union([
|
|
52
|
+
z.object({ accepted: z.literal(true) }),
|
|
53
|
+
z.object({ accepted: z.literal(false), refusal: refusalSchema }),
|
|
54
|
+
z.object({ ignored: z.literal(true), reason: z.string() })
|
|
97
55
|
]);
|
|
98
|
-
const turnEndSchema = z.looseObject({
|
|
99
|
-
sessionUpdate: z.literal("state_update"),
|
|
100
|
-
state: z.literal("idle"),
|
|
101
|
-
stopReason: z.string().nullish(),
|
|
102
|
-
_meta: z.looseObject({ "final.ai": z.looseObject({ stopReason: z.string().nullish() }).nullish() }).nullish()
|
|
103
|
-
});
|
|
104
|
-
const turnEndOf = (update) => {
|
|
105
|
-
const parsed = turnEndSchema.safeParse(update);
|
|
106
|
-
if (!parsed.success) return null;
|
|
107
|
-
return {
|
|
108
|
-
stopReason: parsed.data.stopReason ?? parsed.data._meta?.["final.ai"]?.stopReason ?? null
|
|
109
|
-
};
|
|
110
|
-
};
|
|
111
|
-
const turnEndUpdate = (stopReason) => {
|
|
112
|
-
switch (stopReason) {
|
|
113
|
-
case null:
|
|
114
|
-
return { sessionUpdate: "state_update", state: "idle" };
|
|
115
|
-
case "end_turn":
|
|
116
|
-
return { sessionUpdate: "state_update", state: "idle", stopReason: "end_turn" };
|
|
117
|
-
case "max_tokens":
|
|
118
|
-
return { sessionUpdate: "state_update", state: "idle", stopReason: "max_tokens" };
|
|
119
|
-
case "max_turn_requests":
|
|
120
|
-
return { sessionUpdate: "state_update", state: "idle", stopReason: "max_turn_requests" };
|
|
121
|
-
case "refusal":
|
|
122
|
-
return { sessionUpdate: "state_update", state: "idle", stopReason: "refusal" };
|
|
123
|
-
case "cancelled":
|
|
124
|
-
return { sessionUpdate: "state_update", state: "idle", stopReason: "cancelled" };
|
|
125
|
-
default:
|
|
126
|
-
return {
|
|
127
|
-
sessionUpdate: "state_update",
|
|
128
|
-
state: "idle",
|
|
129
|
-
_meta: { "final.ai": { stopReason } }
|
|
130
|
-
};
|
|
131
|
-
}
|
|
132
|
-
};
|
|
133
56
|
const defineChannel = (definition) => definition;
|
|
134
57
|
export {
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
DecisionEventKind,
|
|
139
|
-
DecisionKind,
|
|
140
|
-
Delivery,
|
|
141
|
-
MessageKind,
|
|
142
|
-
PROJECTED_UPDATE_KINDS,
|
|
143
|
-
ParticipantKind,
|
|
144
|
-
RoutingMode,
|
|
145
|
-
TurnPolicy,
|
|
146
|
-
channelAuthSchema,
|
|
147
|
-
channelMessageInputSchema,
|
|
58
|
+
ChannelAudience,
|
|
59
|
+
ChannelCreate,
|
|
60
|
+
ChannelReplies,
|
|
148
61
|
channelReceiveResultSchema,
|
|
149
|
-
|
|
150
|
-
decisionResolvedDataSchema,
|
|
62
|
+
conversationHandleSchema,
|
|
151
63
|
defineChannel,
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
64
|
+
originSchema,
|
|
65
|
+
personHandleSchema,
|
|
66
|
+
placePolicySchema,
|
|
67
|
+
placeRefSchema,
|
|
68
|
+
principalRefSchema,
|
|
69
|
+
refusalSchema
|
|
155
70
|
};
|
|
156
71
|
//# sourceMappingURL=channel.mjs.map
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../src/channel.ts"],
|
|
4
|
-
"sourcesContent": ["import type { HostedBindingsIface } from \"./hosted-bindings.mjs\";\nimport type { ContentBlock, SessionUpdate } from '@agentclientprotocol/sdk/experimental/v2';\nimport type { SessionUpdateKind } from '@finalai/acp-session';\nimport * as z from 'zod';\nimport type { ChannelSessionOperationsIface } from \"./channel-context.mjs\";\nimport { jsonObjectSchema, jsonValueSchema, type JsonObject, type JsonValue } from \"./json.mjs\";\nimport type { ProviderRef } from \"./provider-ref.mjs\";\nimport type { SemanticChannelEventKind } from \"./semantic-events.mjs\";\n\n// Channels. Messaging has no orchestrator: a channel\n// receives input, inserts it into the conversation, routes it to agent\n// participants as ACP prompt or observe, and projects ACP updates back into\n// visible messages and cards. The built-in messaging channels implement this\n// contract with no private hooks into the session service; the session\n// service hands every channel the same ChannelPlatformIface.\n//\n// Members of a conversation are people and agents. Everything else an agent\n// hears (a schedule, a webhook, a Goal, another agent or channel) is channel\n// input from a principal (`ChannelAuthIface`), sent with\n// `channelSessions.send`; it is never a message.\n\nexport enum ChannelPrincipalType {\n User = 'user',\n Service = 'service',\n}\n\n// Who a channel authenticated for an input or a response. Channels vouch for\n// their principals; one principal per authenticator (`slack:<user>`), so\n// the same person on two surfaces is two principals.\nexport interface ChannelAuthIface extends JsonObject {\n principalId: string;\n principalType: ChannelPrincipalType | `${ChannelPrincipalType}`;\n authenticator: string;\n // `displayName` (a string) when the channel names the principal; see principalDisplayName.\n attributes: JsonObject;\n}\n\nexport const channelAuthSchema = z.object({\n principalId: z.string().min(1),\n principalType: z.nativeEnum(ChannelPrincipalType),\n authenticator: z.string().min(1),\n // How the agent and the people reading its reply name the principal.\n displayName: z.string().min(1).max(200).optional(),\n attributes: jsonObjectSchema.default({}),\n});\n\n// How a principal is named to the agent and in captions: its `displayName`, else its id.\nexport const principalDisplayName = (auth: ChannelAuthIface): string => {\n const name = auth['displayName'];\n return typeof name === 'string' && name.length > 0 ? name : auth.principalId;\n};\n\nexport enum ConversationKind {\n Direct = 'direct',\n Group = 'group',\n}\n\nexport enum ParticipantKind {\n User = 'user',\n Agent = 'agent',\n}\n\nexport enum RoutingMode {\n Mention = 'mention',\n All = 'all',\n Default = 'default',\n}\n\nexport enum TurnPolicy {\n Steer = 'steer',\n Queue = 'queue',\n}\n\nexport enum Delivery {\n Prompt = 'prompt',\n Observe = 'observe',\n}\n\nexport enum MessageKind {\n Message = 'message',\n Card = 'card',\n}\n\nexport enum CardKind {\n Elicitation = 'elicitation',\n Permission = 'permission',\n Notice = 'notice',\n}\n\nexport interface ParticipantIface {\n id: string;\n kind: ParticipantKind;\n displayName: string;\n userId: string | null;\n definitionId: string | null;\n routingMode: RoutingMode | null;\n sessionId: string | null;\n // Whether the agent's harness supports _final/session/observe and renders\n // _meta[\"final.ai\"].author; null for non-agents.\n supportsObserve: boolean | null;\n rendersAuthorMeta: boolean | null;\n left: boolean;\n}\n\nexport const channelReceiveResultSchema = z.union([\n z.object({ conversationId: z.string().min(1) }),\n z.object({ sessionId: z.string().min(1) }),\n z.null(),\n]);\nexport type ChannelReceiveResult = z.infer<typeof channelReceiveResultSchema>;\n\nexport interface ConversationRefIface {\n conversationId: string;\n}\n\nexport interface ConversationIface extends ConversationRefIface {\n organizationId: string;\n kind: ConversationKind;\n title: string | null;\n isHome: boolean;\n turnPolicy: TurnPolicy;\n}\n\nexport interface MessageRefIface {\n messageId: string;\n seq: number;\n}\n\nexport interface ConversationMessageIface extends MessageRefIface {\n conversationId: string;\n authorParticipantId: string;\n kind: MessageKind;\n body: string;\n content: ContentBlock[];\n replyToMessageId: string | null;\n threadRootId: string | null;\n // Earlier messages of the conversation the author quoted, in order.\n quotedMessageIds: string[];\n // Agent participant ids explicitly mentioned in the message.\n mentionedParticipantIds: string[];\n // Number of agent-authored hops that led to this message (0 for humans).\n hopDepth: number;\n // The originating agent for a tool-posted message, including linked conversations.\n agentAuthorDefinitionId?: string | null;\n createdAt: string;\n}\n\nexport interface RouteArgsIface {\n conversation: ConversationIface;\n message: ConversationMessageIface;\n participants: ParticipantIface[];\n agentParticipantId?: string;\n}\n\nexport interface RouteDecisionIface {\n participantId: string;\n delivery: Delivery;\n}\n\nexport interface PostMessageArgsIface {\n conversationId: string;\n authorParticipantId: string;\n kind?: MessageKind;\n content: ContentBlock[];\n replyToMessageId?: string | null;\n threadRootId?: string | null;\n quotedMessageIds?: string[];\n clientMessageId?: string | null;\n mentionedParticipantIds?: string[];\n attachmentIds?: string[];\n hopDepth?: number;\n // A tool or linked-conversation event carries the turn that produced it.\n originTurnId?: string | null;\n // Projection provenance for agent replies.\n source?: { turnId: string; fromSeq: number; toSeq: number } | null;\n}\n\nexport const channelMessageInputSchema = z.object({\n conversationId: z.string().min(1),\n authorParticipantId: z.string().min(1),\n kind: z.nativeEnum(MessageKind).default(MessageKind.Message),\n content: z.array(jsonObjectSchema).min(1),\n clientMessageId: z.string().min(1).nullish(),\n replyToMessageId: z.string().min(1).nullish(),\n threadRootId: z.string().min(1).nullish(),\n quotedMessageIds: z.array(z.string().min(1)).default([]),\n mentionedParticipantIds: z.array(z.string().min(1)).default([]),\n});\n\nexport interface CardArgsIface {\n conversationId: string;\n authorParticipantId: string;\n kind: CardKind;\n decisionId: string | null;\n // Generic cards only: a title, body, options, and entity links (a Goal is an\n // entity link, not a card kind).\n state: JsonObject;\n entityLinks: {\n kind: string;\n id: string;\n title?: string;\n url?: string;\n description?: string;\n imageUrl?: string;\n }[];\n}\n\nexport interface PromptArgsIface {\n waitForAcceptance?: boolean;\n channelBinding?: { id: string; revisionId: string };\n auth?: ChannelAuthIface | null;\n title?: string;\n participantId: string;\n content: ContentBlock[];\n turnPolicy: TurnPolicy;\n replyExpected: boolean;\n idempotencyKey: string;\n // Who prompted (for payer resolution and decision audience).\n authorParticipantId: string;\n // The person a prompt from no person acts for (payer and audience).\n actingUserId?: string | null;\n audienceParticipantIds: string[];\n sourceMessageId: string;\n}\n\nexport interface ObserveArgsIface {\n participantId: string;\n content: ContentBlock[];\n idempotencyKey: string;\n}\n\n// What the session service lets a channel do. Implemented once, handed to\n// built-in and custom channels alike.\nexport interface ChannelPlatformIface {\n channelSessions?: ChannelSessionOperationsIface;\n conversations: {\n get(conversationId: string): Promise<ConversationIface | null>;\n createAttachmentUpload?(args: {\n conversationId: string;\n name: string;\n contentType: string;\n sizeBytes: number;\n }): Promise<{\n attachmentId: string;\n uploadUrl: string;\n method: string;\n headers: Record<string, string>;\n expiresAt: string;\n }>;\n getAttachmentUrl?(args: {\n conversationId: string;\n attachmentId: string;\n }): Promise<{ attachmentId: string; url: string; expiresAt: string }>;\n // Dispatch a stored reply to each recipient's binding; each channel owns routing.\n dispatchMessage?(args: {\n conversationId: string;\n messageId: string;\n participantId?: string;\n requestedDelivery?: Delivery;\n }): Promise<void>;\n findOrCreateDirect(args: {\n organizationId: string;\n userId: string;\n definitionId: string;\n }): Promise<ConversationIface>;\n // The conversation a channel binding is attached to.\n boundTo(bindingId: string): Promise<ConversationIface | null>;\n participants(conversationId: string): Promise<ParticipantIface[]>;\n postMessage(args: PostMessageArgsIface): Promise<ConversationMessageIface>;\n updateMessage(args: {\n messageId: string;\n content: ContentBlock[];\n final: boolean;\n }): Promise<void>;\n postCard(args: CardArgsIface): Promise<ConversationMessageIface>;\n updateCard(args: { messageId: string; state: JsonObject }): Promise<void>;\n recentMessages(args: {\n conversationId: string;\n limit: number;\n beforeSeq?: number;\n afterSeq?: number;\n }): Promise<ConversationMessageIface[]>;\n // Messages of the conversation by id, however old (reply, thread and quote\n // context outside the recent window); unknown and deleted ones are absent.\n getMessages(args: {\n conversationId: string;\n messageIds: string[];\n }): Promise<ConversationMessageIface[]>;\n };\n sessions: {\n prompt(\n args: PromptArgsIface,\n ): Promise<{ messageId: string; sessionId?: string; turnId?: string }>;\n observe(args: ObserveArgsIface): Promise<void>;\n cancel(args: {\n participantId: string;\n reason?: string;\n throughMessageSeq?: number;\n }): Promise<void>;\n respond?(args: ChannelInputResponseIface): Promise<{ resolved: boolean }>;\n };\n log(message: string, details?: Record<string, JsonValue>): void;\n}\n\nexport interface ChannelInputResponseIface {\n channelBinding?: { id: string; revisionId: string };\n auth?: ChannelAuthIface | null;\n participantId: string;\n decisionId: string;\n outcome: JsonValue;\n actorParticipantId: string;\n userId: string | null;\n}\n\nexport interface ChannelReceiveContextIface {\n bindings?: HostedBindingsIface;\n platform: ChannelPlatformIface;\n organizationId: string;\n definitionId: string | null;\n bindingId: string | null;\n config: JsonObject;\n secrets: { get(name: string): Promise<string | null> };\n // A stored, authenticated delivery to one agent in a shared conversation.\n agentParticipantId?: string;\n message?: ConversationMessageIface;\n conversation?: ConversationIface;\n participants?: readonly ParticipantIface[];\n response?: ChannelInputResponseIface;\n conversationId?: string;\n cancelReason?: string;\n // Preserve this boundary when forwarding a retryable conversation Stop.\n cancelThroughMessageSeq?: number;\n requestedDelivery?: Delivery;\n}\n\n// An HTTP route a channel serves (webhooks), mounted by the front door at\n// /api/events/webhooks/:bindingId<path> and the per-agent aliases.\nexport interface ChannelRouteContextIface {\n bindings?: HostedBindingsIface;\n request: Request;\n secrets: { get(name: string): Promise<string | null> };\n receive: (input: JsonValue) => Promise<ChannelReceiveResult>;\n}\n\nexport interface ChannelSocketIface {\n readonly signal: AbortSignal;\n readonly messages: AsyncIterable<string | Uint8Array>;\n // Authenticate the request before accepting. The selected protocol must have been offered.\n accept(options?: { protocol?: string }): void;\n send(data: string | Uint8Array): void;\n close(code?: number, reason?: string): void;\n}\n\nexport interface HttpChannelRouteDefinitionIface {\n method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n path: string;\n handler: (args: ChannelRouteContextIface) => Promise<Response>;\n}\n\nexport interface WebSocketChannelRouteDefinitionIface {\n method: 'WS';\n path: string;\n // Returning an HTTP response before accept rejects the handshake. The handler lives until close.\n handler: (\n args: ChannelRouteContextIface & { socket: ChannelSocketIface },\n ) => Promise<Response | void>;\n}\n\nexport type RouteDefinitionIface =\n | HttpChannelRouteDefinitionIface\n | WebSocketChannelRouteDefinitionIface;\n\n// The per-turn value a channel keeps between its project and event calls of\n// one turn (the definition's `State`). The platform holds it, so a channel\n// running in a Worker isolate keeps nothing in memory; it starts null each turn\n// and is discarded when the turn's projection finishes.\nexport interface ChannelTurnStateIface<State> {\n get(): State | null;\n set(state: State | null): void;\n}\n\nexport interface ProjectionContextIface<State = JsonValue> {\n bindings?: HostedBindingsIface;\n sessionId?: string;\n platform: ChannelPlatformIface;\n // The binding's config and the agent's secrets (manifest.secrets), as receive gets them:\n // a channel posts its replies back to its own service with them.\n config: JsonObject;\n secrets: { get(name: string): Promise<string | null> };\n conversation: ConversationIface | null;\n agentParticipant: ParticipantIface | null;\n turn: { id: string; promptMessageId: string | null; authorParticipantId: string | null };\n seq: number;\n state: ChannelTurnStateIface<State>;\n}\n\nexport enum DecisionEventKind {\n Created = 'decision.created',\n Resolved = 'decision.resolved',\n}\n\nexport type AcpUpdateKind = SessionUpdate['sessionUpdate'];\n// The update kinds ACP v2 names; AcpUpdateKind also admits any other string.\nexport type KnownAcpUpdateKind = `${SessionUpdateKind}`;\n\nexport type ChannelEventKind =\n | AcpUpdateKind\n | `${DecisionEventKind}`\n | `${SemanticChannelEventKind}`;\n\nexport interface ChannelEventIface {\n type: string;\n data: JsonValue;\n seq: number;\n}\n\nexport type ChannelEventHandler<State = JsonValue> = (\n event: ChannelEventIface,\n ctx: ProjectionContextIface<State>,\n) => Promise<void>;\n\nexport enum DecisionKind {\n Permission = 'permission',\n Elicitation = 'elicitation',\n}\n\n// `data` of a decision.created event: an ACP session/request_permission or\n// elicitation/create request awaiting its audience.\nexport const decisionCreatedDataSchema = z.object({\n decisionId: z.string().min(1),\n kind: z.nativeEnum(DecisionKind),\n audienceParticipantIds: z.array(z.string()),\n request: jsonValueSchema,\n});\n\nexport type DecisionCreatedDataIface = z.infer<typeof decisionCreatedDataSchema>;\n\n// `data` of a decision.resolved event: the answer (or cancellation) as recorded,\n// and the principal a channel answered as (null for Final rooms and expiries).\nexport const decisionResolvedDataSchema = z.object({\n decisionId: z.string().min(1),\n outcome: jsonValueSchema,\n respondedBy: channelAuthSchema.nullable().default(null),\n});\n\nexport type DecisionResolvedDataIface = z.infer<typeof decisionResolvedDataSchema>;\n\n// The visible-output updates `project` receives. After them, the\n// turn's projection ends with one ACP v2 idle `state_update` (turnEndUpdate).\n// Thought, tool, plan and every other update, other state updates included,\n// reach a channel only through an `events` handler for its kind.\nexport const PROJECTED_UPDATE_KINDS: ReadonlySet<AcpUpdateKind> = new Set<AcpUpdateKind>([\n 'agent_message_chunk',\n 'agent_message',\n]);\n\nconst turnEndSchema = z.looseObject({\n sessionUpdate: z.literal('state_update'),\n state: z.literal('idle'),\n stopReason: z.string().nullish(),\n _meta: z\n .looseObject({ 'final.ai': z.looseObject({ stopReason: z.string().nullish() }).nullish() })\n .nullish(),\n});\n\n// The stop reason when the update ends the turn (an idle state_update); null otherwise.\nexport const turnEndOf = (update: SessionUpdate): { stopReason: string | null } | null => {\n const parsed = turnEndSchema.safeParse(update);\n if (!parsed.success) return null;\n return {\n stopReason: parsed.data.stopReason ?? parsed.data._meta?.['final.ai']?.stopReason ?? null,\n };\n};\n\n// The idle state_update that ends a turn, as `project` receives it. A stop\n// reason outside ACP's known set rides in `_meta[\"final.ai\"]` (the SDK types\n// only received values as unknown variants).\nexport const turnEndUpdate = (stopReason: string | null): SessionUpdate => {\n switch (stopReason) {\n case null:\n return { sessionUpdate: 'state_update', state: 'idle' };\n case 'end_turn':\n return { sessionUpdate: 'state_update', state: 'idle', stopReason: 'end_turn' };\n case 'max_tokens':\n return { sessionUpdate: 'state_update', state: 'idle', stopReason: 'max_tokens' };\n case 'max_turn_requests':\n return { sessionUpdate: 'state_update', state: 'idle', stopReason: 'max_turn_requests' };\n case 'refusal':\n return { sessionUpdate: 'state_update', state: 'idle', stopReason: 'refusal' };\n case 'cancelled':\n return { sessionUpdate: 'state_update', state: 'idle', stopReason: 'cancelled' };\n default:\n return {\n sessionUpdate: 'state_update',\n state: 'idle',\n _meta: { 'final.ai': { stopReason } },\n };\n }\n};\n\n// Built-in and custom (bundle) channels implement exactly this; the\n// session service calls nothing else on a channel.\nexport interface ChannelDefinitionIface<Inbound, State = undefined> {\n config?: JsonObject;\n // Installed execution is an optimization for an uncustomized definition.\n installed?: ProviderRef;\n configure?: (config: JsonObject) => ChannelDefinitionIface<Inbound, State>;\n routes?: RouteDefinitionIface[];\n respond?(\n input: ChannelInputResponseIface,\n ctx: ChannelReceiveContextIface,\n ): Promise<{ resolved: boolean }>;\n cancel?(ctx: ChannelReceiveContextIface): Promise<{ accepted: boolean }>;\n // Inserts the input into its conversation and routes it. Returns where it went.\n receive(input: Inbound, ctx: ChannelReceiveContextIface): Promise<ChannelReceiveResult>;\n // Pure: who gets this message, and how. The channel applies it\n // to what it posts, from receive and project.\n route(args: RouteArgsIface): RouteDecisionIface[] | Promise<RouteDecisionIface[]>;\n turnPolicy: TurnPolicy;\n // ACP update \u2192 visible message / card. Called with a turn's\n // PROJECTED_UPDATE_KINDS updates in seq order, then its idle state_update.\n project(update: SessionUpdate, ctx: ProjectionContextIface<State>): Promise<void>;\n events?: Partial<Record<ChannelEventKind, ChannelEventHandler<State>>>;\n}\n\nexport const defineChannel = <Inbound, State = undefined>(\n definition: ChannelDefinitionIface<Inbound, State>,\n): ChannelDefinitionIface<Inbound, State> => definition;\n"],
|
|
5
|
-
"mappings": "
|
|
6
|
-
"names": ["
|
|
4
|
+
"sourcesContent": ["import type { ContentBlock } from '@agentclientprotocol/sdk/experimental/v2';\nimport * as z from 'zod';\nimport { jsonObjectSchema, type JsonObject, type JsonValue } from \"./json.mjs\";\nimport type { ProviderRef } from \"./provider-ref.mjs\";\nimport type { ChannelSocketIface, ChannelTurnStateIface } from \"./room-surface.mjs\";\nimport type { ChannelSemanticDataByKindIface } from \"./semantic-events.mjs\";\n\nexport * from \"./room-surface.mjs\";\n\n// Handles carry no authority until the platform validates their binding and invocation signature.\nexport const personHandleSchema = z.string().min(1).brand<'ChannelPerson'>();\nexport const conversationHandleSchema = z.string().min(1).brand<'ChannelConversation'>();\nexport type PersonHandle = z.infer<typeof personHandleSchema>;\nexport type ConversationHandle = z.infer<typeof conversationHandleSchema>;\n\nexport const principalRefSchema = z.object({\n id: z.string().min(1),\n tenant: z.string().min(1).optional(),\n displayName: z.string().optional(),\n});\nexport type PrincipalRef = z.infer<typeof principalRefSchema>;\nexport interface PlaceRef {\n kind: string;\n id: string;\n tenant?: string;\n parent?: PlaceRef;\n title?: string;\n}\nexport const placeRefSchema: z.ZodType<PlaceRef> = z.lazy(() =>\n z.object({\n kind: z.string().min(1),\n id: z.string().min(1),\n tenant: z.string().min(1).optional(),\n parent: placeRefSchema.optional(),\n title: z.string().optional(),\n }),\n);\nexport interface OriginIface {\n place: PlaceRef;\n ref?: JsonObject;\n}\nexport const originSchema = z.object({ place: placeRefSchema, ref: jsonObjectSchema.optional() });\n\nexport type PersonResolution =\n | { kind: 'member'; person: PersonHandle; displayName: string }\n | { kind: 'unlinked'; linkUrl: string }\n | { kind: 'blocked'; reason: 'not-in-organization' | 'suspended' };\nexport enum ChannelReplies {\n Origin = 'origin',\n All = 'all',\n}\nexport enum ChannelAudience {\n Members = 'members',\n Anyone = 'anyone',\n}\nexport enum ChannelCreate {\n DirectWithAgent = 'direct-with-agent',\n Group = 'group',\n}\nexport const placePolicySchema = z.object({\n replies: z.nativeEnum(ChannelReplies),\n audience: z.nativeEnum(ChannelAudience),\n});\nexport interface PlacePolicy {\n replies: ChannelReplies | `${ChannelReplies}`;\n audience: ChannelAudience | `${ChannelAudience}`;\n}\nexport interface PlaceDefaultsIface extends PlacePolicy {\n create: ChannelCreate | `${ChannelCreate}`;\n}\nexport type PlaceResolution =\n | { kind: 'connected'; conversation: ConversationHandle; policy: PlacePolicy }\n | { kind: 'unconnected'; connectUrl: string; defaults: PlaceDefaultsIface | null };\nexport interface Refusal {\n refused: 'unlinked' | 'no-access' | 'unconnected' | 'not-audience';\n linkUrl?: string;\n connectUrl?: string;\n message: string;\n}\nexport type ChannelReceiveResult =\n | { accepted: true }\n | { accepted: false; refusal: Refusal }\n | { ignored: true; reason: string };\nexport const refusalSchema = z.object({\n refused: z.union([\n z.literal('unlinked'),\n z.literal('no-access'),\n z.literal('unconnected'),\n z.literal('not-audience'),\n ]),\n linkUrl: z.string().optional(),\n connectUrl: z.string().optional(),\n message: z.string(),\n});\nexport const channelReceiveResultSchema = z.union([\n z.object({ accepted: z.literal(true) }),\n z.object({ accepted: z.literal(false), refusal: refusalSchema }),\n z.object({ ignored: z.literal(true), reason: z.string() }),\n]);\nexport interface InstalledAppInfoIface {\n clientId: string;\n clientSecret: string;\n signingSecret?: string;\n}\nexport interface InstalledAppCredential extends InstalledAppInfoIface {\n accessToken: string;\n tenantId?: string;\n externalId?: string;\n expiresAt?: string | null;\n customHeaders?: Record<string, string>;\n}\nexport interface ChannelCredentialsIface {\n // Installed app credentials and metadata are package-only; isolates use token-injecting fetch.\n appInfo(): Promise<InstalledAppInfoIface>;\n app(options?: { tenant?: string }): Promise<InstalledAppCredential>;\n // Explicitly declared project secrets are available in both execution modes.\n secret(name: string): Promise<string | null>;\n fetch: typeof fetch;\n}\nexport interface ChannelPostArgsIface {\n from: PersonHandle;\n content: ContentBlock[];\n context?: string[];\n origin: OriginIface;\n idempotencyKey: string;\n waitForAcceptance?: boolean;\n}\nexport interface ChannelConversationIface {\n post(args: ChannelPostArgsIface): Promise<{ messageId: string; turnId?: string } | Refusal>;\n input(args: {\n label: string;\n principal?: PrincipalRef;\n content: ContentBlock[];\n context?: string[];\n origin: OriginIface;\n idempotencyKey: string;\n waitForAcceptance?: boolean;\n }): Promise<{ inputId: string; turnId?: string } | Refusal>;\n attach(args: {\n origin: OriginIface;\n content: ContentBlock[];\n label: string;\n idempotencyKey: string;\n from?: PersonHandle;\n }): Promise<{ messageId: string } | Refusal>;\n edit(args: {\n externalKey: string;\n by: PersonHandle;\n content: ContentBlock[];\n }): Promise<{ messageId: string } | Refusal>;\n remove(args: { externalKey: string; by: PersonHandle }): Promise<{ removed: boolean } | Refusal>;\n react(args: {\n target: { externalKey: string } | { replyOf: { externalKey: string; turnId: string } };\n emoji: string;\n by: PersonHandle;\n op: 'add' | 'remove';\n }): Promise<{ ok: true } | Refusal>;\n}\nexport type SemanticEvent = {\n [Kind in keyof ChannelSemanticDataByKindIface]: {\n type: Kind;\n data: ChannelSemanticDataByKindIface[Kind];\n seq: number;\n };\n}[keyof ChannelSemanticDataByKindIface];\nexport interface ChannelReceiveContextIface<Config = JsonObject> {\n binding: {\n id: string;\n owner: { kind: 'agent'; definitionId: string } | { kind: 'install'; installId: string };\n };\n config: Config;\n credentials: ChannelCredentialsIface;\n people: {\n resolve(principal: PrincipalRef): Promise<PersonResolution>;\n identify(person: PersonHandle): Promise<PrincipalRef | null>;\n // Tenant-wide uninstall/revocation also disconnects that tenant's places.\n revoke(args: {\n principal?: PrincipalRef;\n tenant?: string;\n reason: 'deactivated' | 'uninstalled' | 'provider-revoked';\n }): Promise<void>;\n confirm(args: { ticket: string; principal: PrincipalRef }): Promise<{ linked: true } | Refusal>;\n };\n places: {\n // Explicit anyone/group defaults may create a Shared chat while resolving a new place.\n resolve(place: PlaceRef): Promise<PlaceResolution>;\n observers(place: PlaceRef): Promise<ConversationHandle[]>;\n connect(\n place: PlaceRef,\n to: {\n by: PersonHandle;\n conversation?: ConversationHandle;\n create?: ChannelCreate | `${ChannelCreate}`;\n },\n ): Promise<ConversationHandle>;\n disconnect(place: PlaceRef, by: PersonHandle): Promise<void>;\n };\n conversation(handle: ConversationHandle): ChannelConversationIface;\n observe(\n handle: ConversationHandle,\n args?: { turnId?: string; signal?: AbortSignal },\n ): AsyncIterable<SemanticEvent>;\n media: {\n transcribe(\n audio: AsyncIterable<Uint8Array>,\n options: {\n encoding: string;\n sampleRate: number;\n language?: string;\n endpointing?: boolean;\n signal?: AbortSignal;\n },\n ): AsyncIterable<{ text: string; final: boolean }>;\n synthesize(\n text: AsyncIterable<string>,\n options: { voice?: string; encoding: string; sampleRate: number; signal?: AbortSignal },\n ): AsyncIterable<Uint8Array>;\n };\n decisions: {\n resolve(args: {\n decisionId: string;\n outcome: JsonValue;\n by: PersonHandle;\n }): Promise<{ resolved: boolean } | Refusal>;\n };\n turns: {\n cancel(args: {\n conversation: ConversationHandle;\n by?: PersonHandle;\n turnId?: string;\n }): Promise<{ accepted: boolean } | Refusal>;\n };\n store: {\n get(key: string): Promise<JsonValue | null>;\n set(key: string, value: JsonValue | null, options?: { ttlSeconds?: number }): Promise<void>;\n };\n log(message: string, details?: JsonObject): void;\n}\nexport interface ChannelEventContextIface<Config = JsonObject, State = JsonValue> extends Pick<\n ChannelReceiveContextIface<Config>,\n 'binding' | 'config' | 'credentials' | 'store' | 'log'\n> {\n origin: OriginIface;\n conversation: ConversationHandle;\n turn: { id: string; agent: { displayName: string } };\n state: ChannelTurnStateIface<State>;\n}\nexport interface ChannelRouteContextIface<\n Config = JsonObject,\n> extends ChannelReceiveContextIface<Config> {\n request: Request;\n authenticatedPrincipal?: PrincipalRef;\n receive(input: JsonValue): Promise<ChannelReceiveResult>;\n}\nexport interface HttpChannelRouteDefinitionIface<Config = JsonObject> {\n method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n path: string;\n handler(args: ChannelRouteContextIface<Config>): Promise<Response>;\n}\nexport interface WebSocketChannelRouteDefinitionIface<Config = JsonObject> {\n method: 'WS';\n path: string;\n handler(\n args: ChannelRouteContextIface<Config> & { socket: ChannelSocketIface },\n ): Promise<Response | void>;\n}\nexport type RouteDefinitionIface<Config = JsonObject> =\n | HttpChannelRouteDefinitionIface<Config>\n | WebSocketChannelRouteDefinitionIface<Config>;\nexport type ChannelEventHandlersIface<Config, State> = {\n [Kind in keyof ChannelSemanticDataByKindIface]?: (\n data: ChannelSemanticDataByKindIface[Kind],\n ctx: ChannelEventContextIface<Config, State>,\n ) => Promise<void>;\n};\nexport type ChannelEventKind = keyof ChannelSemanticDataByKindIface;\nexport interface ChannelDefinitionIface<\n Config = JsonObject,\n Inbound = JsonValue,\n State = JsonValue,\n> {\n name: string;\n config?: Config;\n installed?: ProviderRef;\n configure?(config: Config): ChannelDefinitionIface<Config, Inbound, State>;\n credentials: { app: string | null; secrets?: string[] };\n identity:\n | {\n kind: 'redirect';\n start(\n args: { ticket: string; principal: PrincipalRef },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<URL>;\n }\n | {\n kind: 'challenge';\n deliver(\n args: { principal: PrincipalRef; code: string },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<void>;\n }\n | { kind: 'none' };\n places: { kinds: readonly string[]; defaults?(place: PlaceRef): PlaceDefaultsIface | null };\n routes?: RouteDefinitionIface<Config>[];\n listeners?: {\n key: string;\n run(ctx: ChannelReceiveContextIface<Config> & { signal: AbortSignal }): Promise<void>;\n }[];\n receive(input: Inbound, ctx: ChannelReceiveContextIface<Config>): Promise<ChannelReceiveResult>;\n events?: ChannelEventHandlersIface<Config, State>;\n}\nexport const defineChannel = <Config = JsonObject, Inbound = JsonValue, State = JsonValue>(\n definition: ChannelDefinitionIface<Config, Inbound, State>,\n): ChannelDefinitionIface<Config, Inbound, State> => definition;\n"],
|
|
5
|
+
"mappings": "AACA,YAAY,OAAO;AACnB,SAAS,wBAAyD;AAKlE,cAAc;AAGP,MAAM,qBAAqB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAuB;AACpE,MAAM,2BAA2B,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAA6B;AAIhF,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACpB,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EACnC,aAAa,EAAE,OAAO,EAAE,SAAS;AACnC,CAAC;AASM,MAAM,iBAAsC,EAAE;AAAA,EAAK,MACxD,EAAE,OAAO;AAAA,IACP,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACtB,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACpB,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,IACnC,QAAQ,eAAe,SAAS;AAAA,IAChC,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,CAAC;AACH;AAKO,MAAM,eAAe,EAAE,OAAO,EAAE,OAAO,gBAAgB,KAAK,iBAAiB,SAAS,EAAE,CAAC;AAMzF,IAAK,iBAAL,kBAAKA,oBAAL;AACL,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,SAAM;AAFI,SAAAA;AAAA,GAAA;AAIL,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,aAAU;AACV,EAAAA,iBAAA,YAAS;AAFC,SAAAA;AAAA,GAAA;AAIL,IAAK,gBAAL,kBAAKC,mBAAL;AACL,EAAAA,eAAA,qBAAkB;AAClB,EAAAA,eAAA,WAAQ;AAFE,SAAAA;AAAA,GAAA;AAIL,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,SAAS,EAAE,WAAW,cAAc;AAAA,EACpC,UAAU,EAAE,WAAW,eAAe;AACxC,CAAC;AAqBM,MAAM,gBAAgB,EAAE,OAAO;AAAA,EACpC,SAAS,EAAE,MAAM;AAAA,IACf,EAAE,QAAQ,UAAU;AAAA,IACpB,EAAE,QAAQ,WAAW;AAAA,IACrB,EAAE,QAAQ,aAAa;AAAA,IACvB,EAAE,QAAQ,cAAc;AAAA,EAC1B,CAAC;AAAA,EACD,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,YAAY,EAAE,OAAO,EAAE,SAAS;AAAA,EAChC,SAAS,EAAE,OAAO;AACpB,CAAC;AACM,MAAM,6BAA6B,EAAE,MAAM;AAAA,EAChD,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC;AAAA,EACtC,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,KAAK,GAAG,SAAS,cAAc,CAAC;AAAA,EAC/D,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI,GAAG,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC;AAqNM,MAAM,gBAAgB,CAC3B,eACmD;",
|
|
6
|
+
"names": ["ChannelReplies", "ChannelAudience", "ChannelCreate"]
|
|
7
7
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../src/credentials.ts"],
|
|
4
|
-
"sourcesContent": ["import * as z from 'zod';\nimport { DynamicEvent } from \"./dynamic.mjs\";\n\n// Credential policies. Authors build them from resolver\n// functions; each compiles to a small JSON node so the manifest stays renderable\n// and harnesses never parse a policy. The
|
|
5
|
-
"mappings": "AAAA,YAAY,OAAO;AACnB,SAAS,oBAAoB;
|
|
4
|
+
"sourcesContent": ["import * as z from 'zod';\nimport { DynamicEvent } from \"./dynamic.mjs\";\n\n// Credential policies. Authors build them from resolver\n// functions; each compiles to a small JSON node so the manifest stays renderable\n// and harnesses never parse a policy. The host resolves the policy.\n\nexport enum CredentialPayer {\n AgentOwner = 'agent-owner',\n Organization = 'organization',\n PromptingUser = 'prompting-user',\n ConversationOwner = 'conversation-owner',\n}\n\nexport enum CredentialOwner {\n Payer = 'payer',\n Organization = 'organization',\n}\n\nexport enum CredentialNodeKind {\n Subscription = 'subscription',\n ApiKey = 'api-key',\n Platform = 'platform',\n HarnessOwned = 'harness-owned',\n Custom = 'custom',\n}\n\n// Credential kinds a harness can consume (HarnessDescriptionIface.inference.kinds).\nexport enum InferenceCredentialKind {\n Subscription = 'subscription',\n ApiKey = 'api-key',\n Platform = 'platform',\n HarnessOwned = 'harness-owned',\n}\n\nexport enum CredentialDelivery {\n PerRequest = 'per-request',\n AtOpen = 'at-open',\n}\n\n// Vendors are open strings; these are the ones the broker knows today.\nexport const KNOWN_INFERENCE_VENDORS = [\n 'openai',\n 'anthropic',\n 'openrouter',\n 'google',\n 'bedrock',\n] as const;\n\nexport const subscriptionNodeSchema = z.object({\n kind: z.literal(CredentialNodeKind.Subscription),\n owner: z.nativeEnum(CredentialOwner),\n vendor: z.string().min(1).optional(),\n pin: z.string().min(1).optional(),\n});\n\nexport const apiKeyOwnerNodeSchema = z.object({\n pin: z.string().min(1).optional(),\n kind: z.literal(CredentialNodeKind.ApiKey),\n owner: z.nativeEnum(CredentialOwner),\n vendor: z.string().min(1).optional(),\n});\n\nexport const apiKeySecretNodeSchema = z.object({\n kind: z.literal(CredentialNodeKind.ApiKey),\n secret: z.string().min(1),\n baseUrl: z.string().url().optional(),\n vendor: z.string().min(1).optional(),\n});\n\nexport const platformNodeSchema = z.object({\n kind: z.literal(CredentialNodeKind.Platform),\n budget: z.string().min(1).optional(),\n});\n\nexport const harnessNodeSchema = z.object({\n kind: z.literal(CredentialNodeKind.HarnessOwned),\n});\n\nexport const customNodeSchema = z.object({\n kind: z.literal(CredentialNodeKind.Custom),\n // Bundle export of a defineDynamic resolver returning one of the other nodes,\n // or `{ kind: 'api-key', value }` held in memory by the broker.\n resolver: z.string().min(1),\n events: z.array(z.nativeEnum(DynamicEvent)).default([DynamicEvent.SessionStarted]),\n});\n\nexport const credentialNodeSchema = z.union([\n subscriptionNodeSchema,\n apiKeySecretNodeSchema,\n apiKeyOwnerNodeSchema,\n platformNodeSchema,\n harnessNodeSchema,\n customNodeSchema,\n]);\n\nexport const credentialPolicySchema = z.object({\n payer: z.nativeEnum(CredentialPayer),\n tryInOrder: z.array(credentialNodeSchema).min(1),\n});\n\nexport type SubscriptionNodeIface = z.infer<typeof subscriptionNodeSchema>;\nexport type ApiKeyOwnerNodeIface = z.infer<typeof apiKeyOwnerNodeSchema>;\nexport type ApiKeySecretNodeIface = z.infer<typeof apiKeySecretNodeSchema>;\nexport type PlatformNodeIface = z.infer<typeof platformNodeSchema>;\nexport type HarnessOwnedNodeIface = z.infer<typeof harnessNodeSchema>;\nexport type CustomNodeIface = z.infer<typeof customNodeSchema>;\nexport type CredentialNode = z.infer<typeof credentialNodeSchema>;\nexport type CredentialPolicyIface = z.infer<typeof credentialPolicySchema>;\n\n// What a custom resolver may return at run time: any static node, or a literal\n// key the broker holds in memory and redacts from snapshots.\nexport const customResolverResultSchema = z.union([\n credentialNodeSchema,\n z.object({\n kind: z.literal(CredentialNodeKind.ApiKey),\n value: z.string().min(1),\n vendor: z.string().min(1).optional(),\n baseUrl: z.string().url().optional(),\n }),\n]);\nexport type CustomResolverResult = z.infer<typeof customResolverResultSchema>;\n\ninterface SubscriptionArgsIface {\n owner: CredentialOwner | `${CredentialOwner}`;\n vendor?: string;\n pin?: string;\n}\n\ninterface ApiKeyOwnerArgsIface {\n pin?: string;\n owner: CredentialOwner | `${CredentialOwner}`;\n vendor?: string;\n}\n\ninterface ApiKeySecretArgsIface {\n secret: string;\n baseUrl?: string;\n vendor?: string;\n}\n\ninterface ChainArgsIface {\n payer: CredentialPayer | `${CredentialPayer}`;\n tryInOrder: CredentialNode[];\n}\n\nconst ownerSchema = z.nativeEnum(CredentialOwner);\nconst toOwner = (owner: CredentialOwner | `${CredentialOwner}`): CredentialOwner =>\n ownerSchema.parse(owner);\n\nconst payerSchema = z.nativeEnum(CredentialPayer);\nconst toPayer = (payer: CredentialPayer | `${CredentialPayer}`): CredentialPayer =>\n payerSchema.parse(payer);\n\n// A defineDynamic-shaped value: only the bundle export name is recorded in the\n// manifest; the compiler fills it in when it sees the resolver in the bundle.\ninterface CustomResolverRefIface {\n resolverExport: string;\n events?: DynamicEvent[];\n}\n\nexport const credentials = {\n chain: (args: ChainArgsIface): CredentialPolicyIface =>\n credentialPolicySchema.parse({ payer: toPayer(args.payer), tryInOrder: args.tryInOrder }),\n subscription: (args: SubscriptionArgsIface): SubscriptionNodeIface => {\n const node: SubscriptionNodeIface = {\n kind: CredentialNodeKind.Subscription,\n owner: toOwner(args.owner),\n };\n if (args.vendor != null) node.vendor = args.vendor;\n if (args.pin != null) node.pin = args.pin;\n return node;\n },\n apiKey: (args: ApiKeyOwnerArgsIface | ApiKeySecretArgsIface): CredentialNode => {\n if ('secret' in args) {\n const node: ApiKeySecretNodeIface = { kind: CredentialNodeKind.ApiKey, secret: args.secret };\n if (args.baseUrl != null) node.baseUrl = args.baseUrl;\n if (args.vendor != null) node.vendor = args.vendor;\n return node;\n }\n const node: ApiKeyOwnerNodeIface = {\n kind: CredentialNodeKind.ApiKey,\n owner: toOwner(args.owner),\n };\n if (args.vendor != null) node.vendor = args.vendor;\n if (args.pin != null) node.pin = args.pin;\n return node;\n },\n platform: (args?: { budget?: string }): PlatformNodeIface => {\n const node: PlatformNodeIface = { kind: CredentialNodeKind.Platform };\n if (args?.budget != null) node.budget = args.budget;\n return node;\n },\n harness: (): HarnessOwnedNodeIface => ({ kind: CredentialNodeKind.HarnessOwned }),\n custom: (ref: CustomResolverRefIface): CustomNodeIface => ({\n kind: CredentialNodeKind.Custom,\n resolver: ref.resolverExport,\n events: ref.events ?? [DynamicEvent.SessionStarted],\n }),\n};\n\n// Defaults: personal agents pay with the owner's subscriptions,\n// organization agents with the organization's; both fall back to the platform.\nexport const defaultPersonalCredentialPolicy = (): CredentialPolicyIface =>\n credentials.chain({\n payer: CredentialPayer.AgentOwner,\n tryInOrder: [\n credentials.subscription({ owner: CredentialOwner.Payer }),\n credentials.platform(),\n ],\n });\n\nexport const defaultOrganizationCredentialPolicy = (): CredentialPolicyIface =>\n credentials.chain({\n payer: CredentialPayer.Organization,\n tryInOrder: [\n credentials.subscription({ owner: CredentialOwner.Organization }),\n credentials.platform(),\n ],\n });\n\n// Maps a policy node onto the inference credential kind it produces, for the\n// compatibility report and for the broker dropping entries a harness cannot use.\nexport const inferenceKindOfNode = (node: CredentialNode): InferenceCredentialKind | null => {\n switch (node.kind) {\n case CredentialNodeKind.Subscription:\n return InferenceCredentialKind.Subscription;\n case CredentialNodeKind.ApiKey:\n return InferenceCredentialKind.ApiKey;\n case CredentialNodeKind.Platform:\n return InferenceCredentialKind.Platform;\n case CredentialNodeKind.HarnessOwned:\n return InferenceCredentialKind.HarnessOwned;\n case CredentialNodeKind.Custom:\n return null;\n }\n};\n\n// Why a resolution could not produce a model grant; shown to people as a notice.\nexport enum CredentialFailureReason {\n SubscriptionNotConnected = 'subscription_not_connected',\n UsageExhausted = 'usage_exhausted',\n BudgetExceeded = 'budget_exceeded',\n CredentialInvalid = 'credential_invalid',\n HarnessIncompatible = 'harness_incompatible',\n}\n\n// Why a candidate was skipped during resolution (recorded as fallback_reason).\nexport enum CredentialFallbackReason {\n Archived = 'archived',\n Invalid = 'invalid',\n VendorMismatch = 'vendor_mismatch',\n Exhausted = 'exhausted',\n NotGranted = 'not_granted',\n OverBudget = 'over_budget',\n KindUnsupported = 'kind_unsupported',\n Missing = 'missing',\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["CredentialPayer", "CredentialOwner", "CredentialNodeKind", "InferenceCredentialKind", "CredentialDelivery", "node", "CredentialFailureReason", "CredentialFallbackReason"]
|
|
7
7
|
}
|
package/dist/modules/index.d.mts
CHANGED
|
@@ -12,7 +12,6 @@ export * from "./sandbox/types.mjs";
|
|
|
12
12
|
export * from "./schemas.mjs";
|
|
13
13
|
export * from "./tool-annotations.mjs";
|
|
14
14
|
export * from "./tool-patterns.mjs";
|
|
15
|
-
export * from "./channel-context.mjs";
|
|
16
15
|
export * from "./semantic-events.mjs";
|
|
17
16
|
export * from "./sandbox/snapshots.mjs";
|
|
18
17
|
export { SandboxEditorOperation, sandboxEditorRequestSchema, sandboxEditorResultSchema, sandboxEditorSessionSchema, type SandboxEditorRequestIface, type SandboxEditorResultIface, type SandboxEditorSessionIface, } from "./sandbox/editor.mjs";
|
package/dist/modules/index.mjs
CHANGED
|
@@ -19,7 +19,6 @@ export * from "./sandbox/types.mjs";
|
|
|
19
19
|
export * from "./schemas.mjs";
|
|
20
20
|
export * from "./tool-annotations.mjs";
|
|
21
21
|
export * from "./tool-patterns.mjs";
|
|
22
|
-
export * from "./channel-context.mjs";
|
|
23
22
|
export * from "./semantic-events.mjs";
|
|
24
23
|
export * from "./sandbox/snapshots.mjs";
|
|
25
24
|
import {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../src/index.ts"],
|
|
4
|
-
"sourcesContent": ["export {\n ProcessInspectionOperation,\n inspectedProcessSchema,\n processInspectionDetailSchema,\n processInspectionPageSchema,\n processInspectionRequestSchema,\n processInspectionResultSchema,\n type InspectedProcessIface,\n type ProcessInspectionDetailIface,\n type ProcessInspectionPageIface,\n type ProcessInspectionRequestIface,\n type ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nexport * from \"./channel.mjs\";\nexport * from \"./credentials.mjs\";\nexport * from \"./dynamic.mjs\";\nexport * from \"./harness.mjs\";\nexport * from \"./hosted-bindings.mjs\";\nexport * from \"./json.mjs\";\nexport * from \"./manifest.mjs\";\nexport * from \"./provider-ref.mjs\";\nexport * from \"./sandbox/open-scope.mjs\";\nexport * from \"./sandbox/types.mjs\";\nexport * from \"./schemas.mjs\";\nexport * from \"./tool-annotations.mjs\";\nexport * from \"./tool-patterns.mjs\";\n\nexport * from \"./
|
|
5
|
-
"mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AAEd,cAAc;AAEd
|
|
4
|
+
"sourcesContent": ["export {\n ProcessInspectionOperation,\n inspectedProcessSchema,\n processInspectionDetailSchema,\n processInspectionPageSchema,\n processInspectionRequestSchema,\n processInspectionResultSchema,\n type InspectedProcessIface,\n type ProcessInspectionDetailIface,\n type ProcessInspectionPageIface,\n type ProcessInspectionRequestIface,\n type ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nexport * from \"./channel.mjs\";\nexport * from \"./credentials.mjs\";\nexport * from \"./dynamic.mjs\";\nexport * from \"./harness.mjs\";\nexport * from \"./hosted-bindings.mjs\";\nexport * from \"./json.mjs\";\nexport * from \"./manifest.mjs\";\nexport * from \"./provider-ref.mjs\";\nexport * from \"./sandbox/open-scope.mjs\";\nexport * from \"./sandbox/types.mjs\";\nexport * from \"./schemas.mjs\";\nexport * from \"./tool-annotations.mjs\";\nexport * from \"./tool-patterns.mjs\";\n\nexport * from \"./semantic-events.mjs\";\n\nexport * from \"./sandbox/snapshots.mjs\";\n\nexport {\n SandboxEditorOperation,\n sandboxEditorRequestSchema,\n sandboxEditorResultSchema,\n sandboxEditorSessionSchema,\n type SandboxEditorRequestIface,\n type SandboxEditorResultIface,\n type SandboxEditorSessionIface,\n} from \"./sandbox/editor.mjs\";\n"],
|
|
5
|
+
"mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AAEd,cAAc;AAEd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { ChannelReceiveContextIface, InstalledAppCredential, InstalledAppInfoIface } from "./channel.mjs";
|
|
2
|
+
import type { JsonObject } from "./json.mjs";
|
|
3
|
+
export interface LocalChannelContextOptionsIface {
|
|
4
|
+
config?: JsonObject;
|
|
5
|
+
secret(name: string): Promise<string | null>;
|
|
6
|
+
app?: InstalledAppCredential;
|
|
7
|
+
appInfo?: InstalledAppInfoIface;
|
|
8
|
+
fetch?: typeof fetch;
|
|
9
|
+
}
|
|
10
|
+
export declare const createLocalChannelContext: (options: LocalChannelContextOptionsIface) => ChannelReceiveContextIface;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
const createLocalChannelContext = (options) => {
|
|
2
|
+
const unavailable = () => {
|
|
3
|
+
throw new Error("This channel operation needs an authenticated Final host.");
|
|
4
|
+
};
|
|
5
|
+
const noStream = () => ({
|
|
6
|
+
[Symbol.asyncIterator]: () => ({ next: async () => unavailable() })
|
|
7
|
+
});
|
|
8
|
+
return {
|
|
9
|
+
binding: { id: "local", owner: { kind: "agent", definitionId: "local" } },
|
|
10
|
+
config: options.config ?? {},
|
|
11
|
+
credentials: {
|
|
12
|
+
appInfo: async () => {
|
|
13
|
+
const app = options.appInfo ?? options.app ?? unavailable();
|
|
14
|
+
return {
|
|
15
|
+
clientId: app.clientId,
|
|
16
|
+
clientSecret: app.clientSecret,
|
|
17
|
+
...app.signingSecret == null ? {} : { signingSecret: app.signingSecret }
|
|
18
|
+
};
|
|
19
|
+
},
|
|
20
|
+
app: async () => options.app ?? unavailable(),
|
|
21
|
+
secret: options.secret,
|
|
22
|
+
fetch: options.fetch ?? globalThis.fetch
|
|
23
|
+
},
|
|
24
|
+
people: {
|
|
25
|
+
resolve: async () => unavailable(),
|
|
26
|
+
identify: async () => unavailable(),
|
|
27
|
+
confirm: async () => unavailable(),
|
|
28
|
+
revoke: async () => unavailable()
|
|
29
|
+
},
|
|
30
|
+
places: {
|
|
31
|
+
resolve: async () => unavailable(),
|
|
32
|
+
observers: async () => unavailable(),
|
|
33
|
+
connect: async () => unavailable(),
|
|
34
|
+
disconnect: async () => unavailable()
|
|
35
|
+
},
|
|
36
|
+
conversation: () => ({
|
|
37
|
+
post: async () => unavailable(),
|
|
38
|
+
input: async () => unavailable(),
|
|
39
|
+
attach: async () => unavailable(),
|
|
40
|
+
edit: async () => unavailable(),
|
|
41
|
+
remove: async () => unavailable(),
|
|
42
|
+
react: async () => unavailable()
|
|
43
|
+
}),
|
|
44
|
+
observe: noStream,
|
|
45
|
+
media: { transcribe: noStream, synthesize: noStream },
|
|
46
|
+
decisions: { resolve: async () => unavailable() },
|
|
47
|
+
turns: { cancel: async () => unavailable() },
|
|
48
|
+
store: { get: async () => unavailable(), set: async () => unavailable() },
|
|
49
|
+
log: () => void 0
|
|
50
|
+
};
|
|
51
|
+
};
|
|
52
|
+
export {
|
|
53
|
+
createLocalChannelContext
|
|
54
|
+
};
|
|
55
|
+
//# sourceMappingURL=local-channel-context.mjs.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../../../src/local-channel-context.ts"],
|
|
4
|
+
"sourcesContent": ["import type {\n ChannelReceiveContextIface,\n InstalledAppCredential,\n InstalledAppInfoIface,\n} from \"./channel.mjs\";\nimport type { JsonObject } from \"./json.mjs\";\nexport interface LocalChannelContextOptionsIface {\n config?: JsonObject;\n secret(name: string): Promise<string | null>;\n app?: InstalledAppCredential;\n appInfo?: InstalledAppInfoIface;\n fetch?: typeof fetch;\n}\n// Local route previews can validate and log ingress; authenticated platform operations require a host.\nexport const createLocalChannelContext = (\n options: LocalChannelContextOptionsIface,\n): ChannelReceiveContextIface => {\n const unavailable = (): never => {\n throw new Error('This channel operation needs an authenticated Final host.');\n };\n const noStream = (): AsyncIterable<never> => ({\n [Symbol.asyncIterator]: () => ({ next: async () => unavailable() }),\n });\n return {\n binding: { id: 'local', owner: { kind: 'agent', definitionId: 'local' } },\n config: options.config ?? {},\n credentials: {\n appInfo: async () => {\n const app = options.appInfo ?? options.app ?? unavailable();\n return {\n clientId: app.clientId,\n clientSecret: app.clientSecret,\n ...(app.signingSecret == null ? {} : { signingSecret: app.signingSecret }),\n };\n },\n app: async () => options.app ?? unavailable(),\n secret: options.secret,\n fetch: options.fetch ?? globalThis.fetch,\n },\n people: {\n resolve: async () => unavailable(),\n identify: async () => unavailable(),\n confirm: async () => unavailable(),\n revoke: async () => unavailable(),\n },\n places: {\n resolve: async () => unavailable(),\n observers: async () => unavailable(),\n connect: async () => unavailable(),\n disconnect: async () => unavailable(),\n },\n conversation: () => ({\n post: async () => unavailable(),\n input: async () => unavailable(),\n attach: async () => unavailable(),\n edit: async () => unavailable(),\n remove: async () => unavailable(),\n react: async () => unavailable(),\n }),\n observe: noStream,\n media: { transcribe: noStream, synthesize: noStream },\n decisions: { resolve: async () => unavailable() },\n turns: { cancel: async () => unavailable() },\n store: { get: async () => unavailable(), set: async () => unavailable() },\n log: () => undefined,\n };\n};\n"],
|
|
5
|
+
"mappings": "AAcO,MAAM,4BAA4B,CACvC,YAC+B;AAC/B,QAAM,cAAc,MAAa;AAC/B,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,QAAM,WAAW,OAA6B;AAAA,IAC5C,CAAC,OAAO,aAAa,GAAG,OAAO,EAAE,MAAM,YAAY,YAAY,EAAE;AAAA,EACnE;AACA,SAAO;AAAA,IACL,SAAS,EAAE,IAAI,SAAS,OAAO,EAAE,MAAM,SAAS,cAAc,QAAQ,EAAE;AAAA,IACxE,QAAQ,QAAQ,UAAU,CAAC;AAAA,IAC3B,aAAa;AAAA,MACX,SAAS,YAAY;AACnB,cAAM,MAAM,QAAQ,WAAW,QAAQ,OAAO,YAAY;AAC1D,eAAO;AAAA,UACL,UAAU,IAAI;AAAA,UACd,cAAc,IAAI;AAAA,UAClB,GAAI,IAAI,iBAAiB,OAAO,CAAC,IAAI,EAAE,eAAe,IAAI,cAAc;AAAA,QAC1E;AAAA,MACF;AAAA,MACA,KAAK,YAAY,QAAQ,OAAO,YAAY;AAAA,MAC5C,QAAQ,QAAQ;AAAA,MAChB,OAAO,QAAQ,SAAS,WAAW;AAAA,IACrC;AAAA,IACA,QAAQ;AAAA,MACN,SAAS,YAAY,YAAY;AAAA,MACjC,UAAU,YAAY,YAAY;AAAA,MAClC,SAAS,YAAY,YAAY;AAAA,MACjC,QAAQ,YAAY,YAAY;AAAA,IAClC;AAAA,IACA,QAAQ;AAAA,MACN,SAAS,YAAY,YAAY;AAAA,MACjC,WAAW,YAAY,YAAY;AAAA,MACnC,SAAS,YAAY,YAAY;AAAA,MACjC,YAAY,YAAY,YAAY;AAAA,IACtC;AAAA,IACA,cAAc,OAAO;AAAA,MACnB,MAAM,YAAY,YAAY;AAAA,MAC9B,OAAO,YAAY,YAAY;AAAA,MAC/B,QAAQ,YAAY,YAAY;AAAA,MAChC,MAAM,YAAY,YAAY;AAAA,MAC9B,QAAQ,YAAY,YAAY;AAAA,MAChC,OAAO,YAAY,YAAY;AAAA,IACjC;AAAA,IACA,SAAS;AAAA,IACT,OAAO,EAAE,YAAY,UAAU,YAAY,SAAS;AAAA,IACpD,WAAW,EAAE,SAAS,YAAY,YAAY,EAAE;AAAA,IAChD,OAAO,EAAE,QAAQ,YAAY,YAAY,EAAE;AAAA,IAC3C,OAAO,EAAE,KAAK,YAAY,YAAY,GAAG,KAAK,YAAY,YAAY,EAAE;AAAA,IACxE,KAAK,MAAM;AAAA,EACb;AACF;",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { ChannelSocketIface } from "./channel.mjs";
|
|
2
2
|
import { type ChannelSocketAction } from "./channel-socket.mjs";
|
|
3
3
|
import type { JsonValue } from "./json.mjs";
|
|
4
4
|
export interface ChannelSocketConnectionIface {
|
|
@@ -15,9 +15,13 @@ export type ChannelSocketOpenResult = {
|
|
|
15
15
|
ok: false;
|
|
16
16
|
response: Response;
|
|
17
17
|
};
|
|
18
|
-
export declare const openChannelSocket:
|
|
19
|
-
|
|
20
|
-
|
|
18
|
+
export declare const openChannelSocket: <Context extends {
|
|
19
|
+
request: Request;
|
|
20
|
+
}>(args: {
|
|
21
|
+
handler: (context: Context & {
|
|
22
|
+
socket: ChannelSocketIface;
|
|
23
|
+
}) => Promise<Response | void>;
|
|
24
|
+
context: Context;
|
|
21
25
|
signal: AbortSignal;
|
|
22
26
|
handshakeTimeoutMs?: number;
|
|
23
27
|
}) => Promise<ChannelSocketOpenResult>;
|
|
@@ -63,19 +63,7 @@ const openChannelSocket = async (args) => {
|
|
|
63
63
|
reader2.releaseLock();
|
|
64
64
|
}
|
|
65
65
|
};
|
|
66
|
-
const context =
|
|
67
|
-
request: args.context.request,
|
|
68
|
-
secrets: {
|
|
69
|
-
get: (name) => {
|
|
70
|
-
signal.throwIfAborted();
|
|
71
|
-
return args.context.secrets.get(name);
|
|
72
|
-
}
|
|
73
|
-
},
|
|
74
|
-
receive: (value) => {
|
|
75
|
-
signal.throwIfAborted();
|
|
76
|
-
return args.context.receive(value);
|
|
77
|
-
}
|
|
78
|
-
};
|
|
66
|
+
const context = args.context;
|
|
79
67
|
const handshake = setTimeout(close, args.handshakeTimeoutMs ?? 3e4);
|
|
80
68
|
void runChannelSocketHandler({
|
|
81
69
|
handler: args.handler,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../src/local-channel-socket.ts"],
|
|
4
|
-
"sourcesContent": ["import type {
|
|
5
|
-
"mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,qBAAqB;AAgB9B,MAAM,aAAa,CAAC,SAAyB,IAAI,YAAY,EAAE,OAAO,IAAI,EAAE;AAErE,MAAM,oBAAoB,
|
|
4
|
+
"sourcesContent": ["import type { ChannelSocketIface } from \"./channel.mjs\";\nimport {\n ChannelSocketActionKind,\n channelSocketData,\n channelSocketMessage,\n runChannelSocketHandler,\n type ChannelSocketAction,\n} from \"./channel-socket.mjs\";\nimport type { JsonValue } from \"./json.mjs\";\nimport { base64ToBytes } from \"./sandbox/bytes.mjs\";\nexport interface ChannelSocketConnectionIface {\n actions: AsyncIterable<ChannelSocketAction>;\n send(data: string | Uint8Array): void;\n close(): void;\n}\n\nexport type ChannelSocketOpenResult =\n | {\n ok: true;\n protocol: string | null;\n metadata?: JsonValue;\n connection: ChannelSocketConnectionIface;\n }\n | { ok: false; response: Response };\n\nconst byteLength = (text: string): number => new TextEncoder().encode(text).byteLength;\n\nexport const openChannelSocket = async <Context extends { request: Request }>(args: {\n handler: (context: Context & { socket: ChannelSocketIface }) => Promise<Response | void>;\n context: Context;\n signal: AbortSignal;\n handshakeTimeoutMs?: number;\n}): Promise<ChannelSocketOpenResult> => {\n args.signal.throwIfAborted();\n const closing = new AbortController();\n const signal = AbortSignal.any([args.signal, closing.signal]);\n let input: ReadableStreamDefaultController<string | Uint8Array> | null = null;\n let output: ReadableStreamDefaultController<ChannelSocketAction> | null = null;\n const messages = new ReadableStream<string | Uint8Array>(\n {\n start: (controller) => {\n input = controller;\n },\n },\n {\n highWaterMark: 8 * 1024 * 1024,\n size: (data) => (data instanceof Uint8Array ? data.byteLength : byteLength(data)),\n },\n );\n const actions = new ReadableStream<ChannelSocketAction>(\n {\n start: (controller) => {\n output = controller;\n },\n },\n { highWaterMark: 8 * 1024 * 1024, size: (action) => byteLength(JSON.stringify(action)) },\n );\n const close = (): void => {\n if (closing.signal.aborted) return;\n closing.abort();\n signal.removeEventListener('abort', close);\n try {\n input?.close();\n } catch {\n /* closed */\n }\n try {\n output?.close();\n } catch {\n /* closed */\n }\n };\n signal.addEventListener('abort', close, { once: true });\n const readMessages = async function* (): AsyncGenerator<string | Uint8Array> {\n const reader = messages.getReader();\n const cancel = () => {\n void reader.cancel().catch(() => undefined);\n };\n signal.addEventListener('abort', cancel, { once: true });\n if (signal.aborted) cancel();\n try {\n for (;;) {\n const item = await reader.read();\n if (item.done) return;\n yield item.value;\n }\n } finally {\n signal.removeEventListener('abort', cancel);\n reader.releaseLock();\n }\n };\n const context = args.context;\n const handshake = setTimeout(close, args.handshakeTimeoutMs ?? 30_000);\n void runChannelSocketHandler({\n handler: args.handler,\n context,\n signal,\n messages: readMessages(),\n emit: (action) => {\n if (signal.aborted) return;\n output?.enqueue(action);\n if ((output?.desiredSize ?? 0) < 0) close();\n },\n })\n .catch(close)\n .finally(close);\n const reader = actions.getReader();\n const first = await reader.read();\n clearTimeout(handshake);\n if (first.value?.kind === ChannelSocketActionKind.Reject) {\n close();\n reader.releaseLock();\n const bytes = base64ToBytes(first.value.body);\n return {\n ok: false,\n response: new Response(bytes.byteLength === 0 ? null : new Uint8Array(bytes), {\n status: first.value.status,\n headers: first.value.headers,\n }),\n };\n }\n if (first.value?.kind !== ChannelSocketActionKind.Accept) {\n close();\n reader.releaseLock();\n return { ok: false, response: new Response('Channel socket did not accept', { status: 504 }) };\n }\n const outgoing = async function* (): AsyncGenerator<ChannelSocketAction> {\n try {\n for (;;) {\n const item = await reader.read();\n if (item.done) return;\n yield item.value;\n }\n } finally {\n reader.releaseLock();\n close();\n }\n };\n return {\n ok: true,\n protocol: first.value.protocol ?? null,\n connection: {\n actions: outgoing(),\n close,\n send: (data) => {\n signal.throwIfAborted();\n const message = channelSocketData(channelSocketMessage(data));\n input?.enqueue(message);\n if ((input?.desiredSize ?? 0) < 0) close();\n },\n },\n };\n};\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["reader"]
|
|
7
7
|
}
|