@multiplayer-app/ai-agent-types 0.0.1-beta.2

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 (6) hide show
  1. package/README.md +11 -0
  2. package/dist/index.d.ts +174 -0
  3. package/dist/index.d.ts.map +1 -0
  4. package/dist/index.js +69 -0
  5. package/dist/index.js.map +1 -0
  6. package/package.json +22 -0
package/README.md ADDED
@@ -0,0 +1,11 @@
1
+ # @multiplayer-app/ai-agent-types
2
+
3
+ Shared TypeScript contracts for Multiplayer AI agent clients, transports, and services.
4
+
5
+ ## Scripts
6
+
7
+ ```bash
8
+ npm run build
9
+ ```
10
+
11
+ Generates `dist/index.js` and `dist/index.d.ts` for downstream packages.
package/dist/index.d.ts ADDED
@@ -0,0 +1,174 @@
1
+ export declare enum MessageRole {
2
+ System = "system",
3
+ User = "user",
4
+ Assistant = "assistant",
5
+ Tool = "tool",
6
+ Reasoning = "reasoning",
7
+ Error = "error"
8
+ }
9
+ export declare enum AgentAttachmentType {
10
+ File = "file",
11
+ Link = "link",
12
+ Artifact = "artifact"
13
+ }
14
+ export declare enum AgentToolCallStatus {
15
+ Pending = "pending",
16
+ Running = "running",
17
+ Succeeded = "succeeded",
18
+ Failed = "failed"
19
+ }
20
+ export declare enum AgentProcessStatus {
21
+ Queued = "queued",
22
+ Running = "running",
23
+ Paused = "paused",
24
+ Error = "error",
25
+ Complete = "complete"
26
+ }
27
+ export declare enum StreamChunkType {
28
+ Message = "message",
29
+ Reasoning = "reasoning",
30
+ Tool = "tool",
31
+ Artifact = "artifact",
32
+ Error = "error",
33
+ Chat = "chat"
34
+ }
35
+ export declare enum ChatType {
36
+ Chat = "chat",
37
+ Agent = "agent"
38
+ }
39
+ export declare enum AgentStatus {
40
+ Processing = "processing",
41
+ Streaming = "streaming",
42
+ Finished = "finished",
43
+ Aborted = "aborted",
44
+ Error = "error"
45
+ }
46
+ export interface AgentAttachment {
47
+ id: string;
48
+ type: AgentAttachmentType;
49
+ name: string;
50
+ url?: string;
51
+ mimeType?: string;
52
+ metadata?: Record<string, unknown>;
53
+ }
54
+ export interface AgentMessage {
55
+ id: string;
56
+ chat: string;
57
+ role: MessageRole;
58
+ content: string;
59
+ createdAt: string;
60
+ reasoning?: string;
61
+ toolCalls?: AgentToolCall[];
62
+ attachments?: AgentAttachment[];
63
+ annotations?: Record<string, unknown>;
64
+ }
65
+ export interface AgentToolCall {
66
+ id: string;
67
+ name: string;
68
+ input: Record<string, unknown>;
69
+ status: AgentToolCallStatus;
70
+ output?: Record<string, unknown>;
71
+ error?: string;
72
+ requiresConfirmation?: boolean;
73
+ }
74
+ export interface AgentChat {
75
+ id: string;
76
+ title?: string;
77
+ type?: ChatType;
78
+ status?: AgentStatus;
79
+ contextKey: string;
80
+ model?: string;
81
+ createdAt: string;
82
+ updatedAt: string;
83
+ metadata?: Record<string, unknown>;
84
+ /**
85
+ * Optional user identifier owning this chat. When omitted we treat it as "guest".
86
+ */
87
+ userId?: string;
88
+ }
89
+ /**
90
+ * AgentChat with messages included. Used for frontend responses.
91
+ */
92
+ export type AgentChatResponse = AgentChat & {
93
+ messages: AgentMessage[];
94
+ };
95
+ export interface AgentProcessSummary {
96
+ id: string;
97
+ status: AgentProcessStatus;
98
+ label: string;
99
+ createdAt: string;
100
+ updatedAt: string;
101
+ sandboxed?: boolean;
102
+ sandboxId?: string;
103
+ }
104
+ export interface SendMessagePayload {
105
+ chatId?: string;
106
+ content: string;
107
+ contextKey: string;
108
+ attachments?: AgentAttachment[];
109
+ metadata?: Record<string, unknown>;
110
+ model?: string;
111
+ temperature?: number;
112
+ /**
113
+ * Optional user identifier. When omitted we treat it as "guest".
114
+ */
115
+ userId?: string;
116
+ }
117
+ export interface StreamChunk {
118
+ type: StreamChunkType;
119
+ /**
120
+ * Optional chat identifier for clients that need to associate
121
+ * streamed chunks with a new chat before messages arrive.
122
+ */
123
+ chatId?: string;
124
+ /**
125
+ * Chat object sent when a new chat is created.
126
+ * Used with StreamChunkType.Chat.
127
+ */
128
+ chat?: AgentChat;
129
+ message?: AgentMessage;
130
+ reasoning?: string;
131
+ toolCall?: AgentToolCall;
132
+ artifactId?: string;
133
+ error?: string;
134
+ done?: boolean;
135
+ }
136
+ export interface AgentArtifact {
137
+ id: string;
138
+ label: string;
139
+ mimeType: string;
140
+ content: string;
141
+ createdAt: string;
142
+ metadata?: Record<string, unknown>;
143
+ }
144
+ export interface AIModel {
145
+ id: string;
146
+ provider: string;
147
+ label: string;
148
+ description?: string;
149
+ }
150
+ export interface ModelOption {
151
+ id: string;
152
+ label: string;
153
+ provider?: string;
154
+ reasoning?: 'disabled' | 'concise' | 'deep';
155
+ contexts?: string[];
156
+ description?: string;
157
+ }
158
+ /**
159
+ * Socket.IO event names for real-time notifications
160
+ */
161
+ export declare const SocketIOEvents: {
162
+ readonly ChatNew: "chat:new";
163
+ readonly MessageNew: "message:new";
164
+ readonly ChatUpdate: "chat:update";
165
+ };
166
+ /**
167
+ * Socket.IO configuration constants
168
+ */
169
+ export declare const SocketIOConfig: {
170
+ readonly Path: "/socket.io";
171
+ readonly UserRoomPrefix: "user:";
172
+ readonly DefaultUserId: "guest";
173
+ };
174
+ //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js ADDED
@@ -0,0 +1,69 @@
1
+ export var MessageRole;
2
+ (function (MessageRole) {
3
+ MessageRole["System"] = "system";
4
+ MessageRole["User"] = "user";
5
+ MessageRole["Assistant"] = "assistant";
6
+ MessageRole["Tool"] = "tool";
7
+ MessageRole["Reasoning"] = "reasoning";
8
+ MessageRole["Error"] = "error";
9
+ })(MessageRole || (MessageRole = {}));
10
+ export var AgentAttachmentType;
11
+ (function (AgentAttachmentType) {
12
+ AgentAttachmentType["File"] = "file";
13
+ AgentAttachmentType["Link"] = "link";
14
+ AgentAttachmentType["Artifact"] = "artifact";
15
+ })(AgentAttachmentType || (AgentAttachmentType = {}));
16
+ export var AgentToolCallStatus;
17
+ (function (AgentToolCallStatus) {
18
+ AgentToolCallStatus["Pending"] = "pending";
19
+ AgentToolCallStatus["Running"] = "running";
20
+ AgentToolCallStatus["Succeeded"] = "succeeded";
21
+ AgentToolCallStatus["Failed"] = "failed";
22
+ })(AgentToolCallStatus || (AgentToolCallStatus = {}));
23
+ export var AgentProcessStatus;
24
+ (function (AgentProcessStatus) {
25
+ AgentProcessStatus["Queued"] = "queued";
26
+ AgentProcessStatus["Running"] = "running";
27
+ AgentProcessStatus["Paused"] = "paused";
28
+ AgentProcessStatus["Error"] = "error";
29
+ AgentProcessStatus["Complete"] = "complete";
30
+ })(AgentProcessStatus || (AgentProcessStatus = {}));
31
+ export var StreamChunkType;
32
+ (function (StreamChunkType) {
33
+ StreamChunkType["Message"] = "message";
34
+ StreamChunkType["Reasoning"] = "reasoning";
35
+ StreamChunkType["Tool"] = "tool";
36
+ StreamChunkType["Artifact"] = "artifact";
37
+ StreamChunkType["Error"] = "error";
38
+ StreamChunkType["Chat"] = "chat";
39
+ })(StreamChunkType || (StreamChunkType = {}));
40
+ export var ChatType;
41
+ (function (ChatType) {
42
+ ChatType["Chat"] = "chat";
43
+ ChatType["Agent"] = "agent";
44
+ })(ChatType || (ChatType = {}));
45
+ export var AgentStatus;
46
+ (function (AgentStatus) {
47
+ AgentStatus["Processing"] = "processing";
48
+ AgentStatus["Streaming"] = "streaming";
49
+ AgentStatus["Finished"] = "finished";
50
+ AgentStatus["Aborted"] = "aborted";
51
+ AgentStatus["Error"] = "error";
52
+ })(AgentStatus || (AgentStatus = {}));
53
+ /**
54
+ * Socket.IO event names for real-time notifications
55
+ */
56
+ export const SocketIOEvents = {
57
+ ChatNew: 'chat:new',
58
+ MessageNew: 'message:new',
59
+ ChatUpdate: 'chat:update'
60
+ };
61
+ /**
62
+ * Socket.IO configuration constants
63
+ */
64
+ export const SocketIOConfig = {
65
+ Path: '/socket.io',
66
+ UserRoomPrefix: 'user:',
67
+ DefaultUserId: 'guest'
68
+ };
69
+ //# sourceMappingURL=index.js.map
package/dist/index.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,8BAAe,CAAA;AACjB,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB;AAED,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,oCAAa,CAAA;IACb,oCAAa,CAAA;IACb,4CAAqB,CAAA;AACvB,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAED,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,0CAAmB,CAAA;IACnB,8CAAuB,CAAA;IACvB,wCAAiB,CAAA;AACnB,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAED,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,yCAAmB,CAAA;IACnB,uCAAiB,CAAA;IACjB,qCAAe,CAAA;IACf,2CAAqB,CAAA;AACvB,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B;AAED,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,gCAAa,CAAA;IACb,wCAAqB,CAAA;IACrB,kCAAe,CAAA;IACf,gCAAa,CAAA;AACf,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAED,MAAM,CAAN,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EAHW,QAAQ,KAAR,QAAQ,QAGnB;AAED,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,sCAAuB,CAAA;IACvB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;AACjB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AA6HD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,aAAa;CACjB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,YAAY;IAClB,cAAc,EAAE,OAAO;IACvB,aAAa,EAAE,OAAO;CACd,CAAC"}
package/package.json ADDED
@@ -0,0 +1,22 @@
1
+ {
2
+ "name": "@multiplayer-app/ai-agent-types",
3
+ "version": "0.0.1-beta.2",
4
+ "description": "Shared TypeScript types for Multiplayer AI agent clients and services",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "files": [
9
+ "dist",
10
+ "README.md"
11
+ ],
12
+ "scripts": {
13
+ "build": "tsc -p tsconfig.json"
14
+ },
15
+ "publishConfig": {
16
+ "access": "public"
17
+ },
18
+ "license": "MIT",
19
+ "devDependencies": {
20
+ "typescript": "5.6.3"
21
+ }
22
+ }