@agentpulselabs/agent-studio-client 0.2.0 → 0.3.1
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/README.md +6 -5
- package/index.d.ts +29 -6
- package/index.js +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -21,12 +21,13 @@ const result = await agent_studio.agentsGetByKey(payload);
|
|
|
21
21
|
|
|
22
22
|
| Method | Op | Summary |
|
|
23
23
|
| --- | --- | --- |
|
|
24
|
-
| `agentsGetByKey` | `agents:get-by-key` | Resolve a team's agent by stable agent_key (team override wins, else the shipped blueprint). |
|
|
24
|
+
| `agentsGetByKey` | `agents:get-by-key` | Resolve a team's agent by stable agent_key (team override wins, else the shipped blueprint); null when the key is unknown. avatar: 'pulse' \| 'voice' \| null (null = the platform default face). |
|
|
25
25
|
| `blueprintsRegister` | `blueprints:register` | Idempotently upsert a GLOBAL agent blueprint + its skill(s) from a self-describing |
|
|
26
|
-
| `conversationsAppend` | `conversations:append` | Append a turn to
|
|
27
|
-
| `conversationsResume` | `conversations:resume` | The
|
|
28
|
-
| `
|
|
26
|
+
| `conversationsAppend` | `conversations:append` | Append a turn to the caller's own conversation (else CONVERSATION_NOT_OWNED), or create a new one owned by the caller when no id is given. createdBy is accepted and ignored. |
|
|
27
|
+
| `conversationsResume` | `conversations:resume` | The transcript array of the caller's own conversation, or [] for any other id (unknown, a teammate's, no owner). |
|
|
28
|
+
| `conversationsResumeOwn` | `conversations:resume-own` | The caller's own conversation: { owned: true, transcript } when the caller created it, else { owned: false } (unknown, a teammate's, no owner, another team's — all alike). |
|
|
29
|
+
| `runtimeExecute` | `runtime:execute` | Run one agent turn (skill-aware tool loop). Streaming op — consume via bridge.stream(). |
|
|
29
30
|
| `widgetActive_agents` | `widget:active_agents` | Home-widget stat: the team's enabled purpose agents (team rows + un-overridden blueprints) of the pool total. |
|
|
30
31
|
| `widgetActive_skills` | `widget:active_skills` | Home-widget stat: the team's enabled skills (team rows + un-overridden blueprints) of the pool total. |
|
|
31
|
-
| `widgetRecent_chats` | `widget:recent_chats` | Home-widget list: the
|
|
32
|
+
| `widgetRecent_chats` | `widget:recent_chats` | Home-widget list: the caller's own 5 most recently updated conversations. |
|
|
32
33
|
| `widgetRegistry_tools` | `widget:registry_tools` | Home-widget stat: count of the platform's non-deprecated operation catalog (tools available to agents). |
|
package/index.d.ts
CHANGED
|
@@ -13,7 +13,19 @@ export interface AgentsGetByKeyInput {
|
|
|
13
13
|
}
|
|
14
14
|
|
|
15
15
|
export interface AgentsGetByKeyOutput {
|
|
16
|
-
|
|
16
|
+
agent_key: string;
|
|
17
|
+
avatar: string | null;
|
|
18
|
+
customised: boolean;
|
|
19
|
+
default_tools: string[];
|
|
20
|
+
description: string | null;
|
|
21
|
+
enabled: boolean;
|
|
22
|
+
id: string;
|
|
23
|
+
is_system: boolean;
|
|
24
|
+
kind: string;
|
|
25
|
+
name: string;
|
|
26
|
+
owner_app: string | null;
|
|
27
|
+
persona_prompt: string | null;
|
|
28
|
+
provider_id: string | null;
|
|
17
29
|
}
|
|
18
30
|
|
|
19
31
|
export interface BlueprintsRegisterInput {
|
|
@@ -40,27 +52,38 @@ export interface ConversationsResumeOutput {
|
|
|
40
52
|
transcript: unknown[];
|
|
41
53
|
}
|
|
42
54
|
|
|
55
|
+
export interface ConversationsResumeOwnInput {
|
|
56
|
+
conversationId: string;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export interface ConversationsResumeOwnOutput {
|
|
60
|
+
owned: boolean;
|
|
61
|
+
transcript?: unknown[];
|
|
62
|
+
}
|
|
63
|
+
|
|
43
64
|
export interface WidgetRecent_chatsOutput {
|
|
44
65
|
empty: string;
|
|
45
66
|
items: unknown[];
|
|
46
67
|
}
|
|
47
68
|
|
|
48
69
|
export interface AgentStudioClient {
|
|
49
|
-
/** Resolve a team's agent by stable agent_key (team override wins, else the shipped blueprint). */
|
|
70
|
+
/** Resolve a team's agent by stable agent_key (team override wins, else the shipped blueprint); null when the key is unknown. avatar: 'pulse' | 'voice' | null (null = the platform default face). */
|
|
50
71
|
agentsGetByKey(payload: AgentsGetByKeyInput): Promise<AgentsGetByKeyOutput>;
|
|
51
72
|
/** Idempotently upsert a GLOBAL agent blueprint + its skill(s) from a self-describing */
|
|
52
73
|
blueprintsRegister(payload: BlueprintsRegisterInput): Promise<BlueprintsRegisterOutput>;
|
|
53
|
-
/** Append a turn to
|
|
74
|
+
/** Append a turn to the caller's own conversation (else CONVERSATION_NOT_OWNED), or create a new one owned by the caller when no id is given. createdBy is accepted and ignored. */
|
|
54
75
|
conversationsAppend(payload: Record<string, unknown>): Promise<ConversationsAppendOutput>;
|
|
55
|
-
/** The
|
|
76
|
+
/** The transcript array of the caller's own conversation, or [] for any other id (unknown, a teammate's, no owner). */
|
|
56
77
|
conversationsResume(payload: ConversationsResumeInput): Promise<ConversationsResumeOutput>;
|
|
57
|
-
/**
|
|
78
|
+
/** The caller's own conversation: { owned: true, transcript } when the caller created it, else { owned: false } (unknown, a teammate's, no owner, another team's — all alike). */
|
|
79
|
+
conversationsResumeOwn(payload: ConversationsResumeOwnInput): Promise<ConversationsResumeOwnOutput>;
|
|
80
|
+
/** Run one agent turn (skill-aware tool loop). Streaming op — consume via bridge.stream(). */
|
|
58
81
|
runtimeExecute(payload: Record<string, unknown>): Promise<unknown>;
|
|
59
82
|
/** Home-widget stat: the team's enabled purpose agents (team rows + un-overridden blueprints) of the pool total. */
|
|
60
83
|
widgetActive_agents(payload: Record<string, unknown>): Promise<unknown>;
|
|
61
84
|
/** Home-widget stat: the team's enabled skills (team rows + un-overridden blueprints) of the pool total. */
|
|
62
85
|
widgetActive_skills(payload: Record<string, unknown>): Promise<unknown>;
|
|
63
|
-
/** Home-widget list: the
|
|
86
|
+
/** Home-widget list: the caller's own 5 most recently updated conversations. */
|
|
64
87
|
widgetRecent_chats(payload: Record<string, unknown>): Promise<WidgetRecent_chatsOutput>;
|
|
65
88
|
/** Home-widget stat: count of the platform's non-deprecated operation catalog (tools available to agents). */
|
|
66
89
|
widgetRegistry_tools(payload: Record<string, unknown>): Promise<unknown>;
|
package/index.js
CHANGED
|
@@ -10,6 +10,7 @@ export function createClient(bridge) {
|
|
|
10
10
|
blueprintsRegister: (payload) => bridge.call({ targetApp: 'agent-studio', operation: 'blueprints:register', payload }),
|
|
11
11
|
conversationsAppend: (payload) => bridge.call({ targetApp: 'agent-studio', operation: 'conversations:append', payload }),
|
|
12
12
|
conversationsResume: (payload) => bridge.call({ targetApp: 'agent-studio', operation: 'conversations:resume', payload }),
|
|
13
|
+
conversationsResumeOwn: (payload) => bridge.call({ targetApp: 'agent-studio', operation: 'conversations:resume-own', payload }),
|
|
13
14
|
runtimeExecute: (payload) => bridge.call({ targetApp: 'agent-studio', operation: 'runtime:execute', payload }),
|
|
14
15
|
widgetActive_agents: (payload) => bridge.call({ targetApp: 'agent-studio', operation: 'widget:active_agents', payload }),
|
|
15
16
|
widgetActive_skills: (payload) => bridge.call({ targetApp: 'agent-studio', operation: 'widget:active_skills', payload }),
|