@stigmer/cli 0.1.2 → 0.2.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 (230) hide show
  1. package/auth/browser.d.ts +7 -0
  2. package/auth/browser.d.ts.map +1 -0
  3. package/auth/browser.js +49 -0
  4. package/auth/browser.js.map +1 -0
  5. package/auth/callback-server.d.ts +8 -3
  6. package/auth/callback-server.d.ts.map +1 -1
  7. package/auth/callback-server.js +53 -19
  8. package/auth/callback-server.js.map +1 -1
  9. package/auth/device.d.ts +23 -0
  10. package/auth/device.d.ts.map +1 -0
  11. package/auth/device.js +119 -0
  12. package/auth/device.js.map +1 -0
  13. package/auth/index.d.ts +4 -3
  14. package/auth/index.d.ts.map +1 -1
  15. package/auth/index.js +4 -3
  16. package/auth/index.js.map +1 -1
  17. package/auth/login.d.ts +49 -1
  18. package/auth/login.d.ts.map +1 -1
  19. package/auth/login.js +161 -51
  20. package/auth/login.js.map +1 -1
  21. package/auth/oidc.d.ts +67 -0
  22. package/auth/oidc.d.ts.map +1 -0
  23. package/auth/oidc.js +213 -0
  24. package/auth/oidc.js.map +1 -0
  25. package/auth/token.d.ts +17 -23
  26. package/auth/token.d.ts.map +1 -1
  27. package/auth/token.js +51 -60
  28. package/auth/token.js.map +1 -1
  29. package/client/client.d.ts.map +1 -1
  30. package/client/client.js +4 -1
  31. package/client/client.js.map +1 -1
  32. package/client/current-organization.d.ts +5 -0
  33. package/client/current-organization.d.ts.map +1 -0
  34. package/client/current-organization.js +15 -0
  35. package/client/current-organization.js.map +1 -0
  36. package/commands/apikey/index.d.ts +16 -1
  37. package/commands/apikey/index.d.ts.map +1 -1
  38. package/commands/apikey/index.js +81 -0
  39. package/commands/apikey/index.js.map +1 -1
  40. package/commands/app-handover.d.ts +17 -0
  41. package/commands/app-handover.d.ts.map +1 -0
  42. package/commands/app-handover.js +155 -0
  43. package/commands/app-handover.js.map +1 -0
  44. package/commands/auth/index.d.ts.map +1 -1
  45. package/commands/auth/index.js +15 -9
  46. package/commands/auth/index.js.map +1 -1
  47. package/commands/auth/login.d.ts +7 -2
  48. package/commands/auth/login.d.ts.map +1 -1
  49. package/commands/auth/login.js +26 -23
  50. package/commands/auth/login.js.map +1 -1
  51. package/commands/auth/whoami.d.ts +5 -0
  52. package/commands/auth/whoami.d.ts.map +1 -1
  53. package/commands/auth/whoami.js +13 -1
  54. package/commands/auth/whoami.js.map +1 -1
  55. package/commands/coding-agent.d.ts +5 -0
  56. package/commands/coding-agent.d.ts.map +1 -0
  57. package/commands/coding-agent.js +30 -0
  58. package/commands/coding-agent.js.map +1 -0
  59. package/commands/config/backend.js +20 -6
  60. package/commands/config/backend.js.map +1 -1
  61. package/commands/embedding.d.ts +28 -0
  62. package/commands/embedding.d.ts.map +1 -0
  63. package/commands/embedding.js +170 -0
  64. package/commands/embedding.js.map +1 -0
  65. package/commands/example.d.ts +13 -0
  66. package/commands/example.d.ts.map +1 -0
  67. package/commands/example.js +126 -0
  68. package/commands/example.js.map +1 -0
  69. package/commands/help.d.ts.map +1 -1
  70. package/commands/help.js +16 -3
  71. package/commands/help.js.map +1 -1
  72. package/commands/load-test/burst.d.ts +64 -0
  73. package/commands/load-test/burst.d.ts.map +1 -0
  74. package/commands/load-test/burst.js +202 -0
  75. package/commands/load-test/burst.js.map +1 -0
  76. package/commands/load-test/index.d.ts +37 -0
  77. package/commands/load-test/index.d.ts.map +1 -0
  78. package/commands/load-test/index.js +154 -0
  79. package/commands/load-test/index.js.map +1 -0
  80. package/commands/load-test/report.d.ts +98 -0
  81. package/commands/load-test/report.d.ts.map +1 -0
  82. package/commands/load-test/report.js +210 -0
  83. package/commands/load-test/report.js.map +1 -0
  84. package/commands/mcp-server.d.ts +3 -3
  85. package/commands/mcp-server.d.ts.map +1 -1
  86. package/commands/mcp-server.js +4 -4
  87. package/commands/mcp-server.js.map +1 -1
  88. package/commands/setup.d.ts +17 -0
  89. package/commands/setup.d.ts.map +1 -1
  90. package/commands/setup.js +71 -1
  91. package/commands/setup.js.map +1 -1
  92. package/commands/up.d.ts.map +1 -1
  93. package/commands/up.js +67 -9
  94. package/commands/up.js.map +1 -1
  95. package/commands/usage.d.ts +15 -0
  96. package/commands/usage.d.ts.map +1 -1
  97. package/commands/usage.js +52 -2
  98. package/commands/usage.js.map +1 -1
  99. package/config/config.d.ts +14 -7
  100. package/config/config.d.ts.map +1 -1
  101. package/config/config.js +5 -1
  102. package/config/config.js.map +1 -1
  103. package/config/index.d.ts +1 -1
  104. package/config/index.d.ts.map +1 -1
  105. package/config/index.js +1 -1
  106. package/config/index.js.map +1 -1
  107. package/config/resolve.d.ts +1 -1
  108. package/config/resolve.d.ts.map +1 -1
  109. package/config/resolve.js +6 -3
  110. package/config/resolve.js.map +1 -1
  111. package/errors/classify.d.ts.map +1 -1
  112. package/errors/classify.js +10 -1
  113. package/errors/classify.js.map +1 -1
  114. package/errors/cli-exit-error.d.ts +3 -1
  115. package/errors/cli-exit-error.d.ts.map +1 -1
  116. package/errors/cli-exit-error.js +6 -2
  117. package/errors/cli-exit-error.js.map +1 -1
  118. package/errors/handle.d.ts +32 -5
  119. package/errors/handle.d.ts.map +1 -1
  120. package/errors/handle.js +67 -8
  121. package/errors/handle.js.map +1 -1
  122. package/local/daemon/components.d.ts +28 -1
  123. package/local/daemon/components.d.ts.map +1 -1
  124. package/local/daemon/components.js +64 -2
  125. package/local/daemon/components.js.map +1 -1
  126. package/local/daemon/host.d.ts.map +1 -1
  127. package/local/daemon/host.js +6 -2
  128. package/local/daemon/host.js.map +1 -1
  129. package/local/daemon/launch.d.ts +12 -4
  130. package/local/daemon/launch.d.ts.map +1 -1
  131. package/local/daemon/launch.js +49 -16
  132. package/local/daemon/launch.js.map +1 -1
  133. package/local/daemon/types.d.ts +9 -1
  134. package/local/daemon/types.d.ts.map +1 -1
  135. package/local/key-check.d.ts +20 -0
  136. package/local/key-check.d.ts.map +1 -0
  137. package/local/key-check.js +45 -0
  138. package/local/key-check.js.map +1 -0
  139. package/local/model-key-step.d.ts +63 -0
  140. package/local/model-key-step.d.ts.map +1 -0
  141. package/local/model-key-step.js +133 -0
  142. package/local/model-key-step.js.map +1 -0
  143. package/local/setup/prompt.d.ts.map +1 -1
  144. package/local/setup/prompt.js +22 -18
  145. package/local/setup/prompt.js.map +1 -1
  146. package/local/setup/wizard.d.ts +10 -0
  147. package/local/setup/wizard.d.ts.map +1 -1
  148. package/local/setup/wizard.js +40 -17
  149. package/local/setup/wizard.js.map +1 -1
  150. package/local/state/lock.d.ts.map +1 -1
  151. package/local/state/lock.js +123 -36
  152. package/local/state/lock.js.map +1 -1
  153. package/local/state/pidfile.d.ts +4 -0
  154. package/local/state/pidfile.d.ts.map +1 -1
  155. package/local/state/pidfile.js +12 -3
  156. package/local/state/pidfile.js.map +1 -1
  157. package/package.json +12 -9
  158. package/program.d.ts.map +1 -1
  159. package/program.js +10 -0
  160. package/program.js.map +1 -1
  161. package/resources/get.js +1 -1
  162. package/resources/get.js.map +1 -1
  163. package/resources/run/stream.d.ts.map +1 -1
  164. package/resources/run/stream.js +2 -1
  165. package/resources/run/stream.js.map +1 -1
  166. package/resources/stream/render-plaintext.d.ts +3 -0
  167. package/resources/stream/render-plaintext.d.ts.map +1 -1
  168. package/resources/stream/render-plaintext.js +20 -2
  169. package/resources/stream/render-plaintext.js.map +1 -1
  170. package/resources/usage.d.ts +8 -0
  171. package/resources/usage.d.ts.map +1 -1
  172. package/resources/usage.js +37 -0
  173. package/resources/usage.js.map +1 -1
  174. package/runtime.d.ts +9 -0
  175. package/runtime.d.ts.map +1 -1
  176. package/runtime.js +12 -1
  177. package/runtime.js.map +1 -1
  178. package/src/auth/browser.ts +57 -0
  179. package/src/auth/callback-server.ts +58 -22
  180. package/src/auth/device.ts +151 -0
  181. package/src/auth/index.ts +4 -3
  182. package/src/auth/login.ts +243 -67
  183. package/src/auth/oidc.ts +270 -0
  184. package/src/auth/token.ts +53 -90
  185. package/src/client/client.ts +4 -1
  186. package/src/client/current-organization.ts +27 -0
  187. package/src/commands/apikey/index.ts +85 -0
  188. package/src/commands/app-handover.ts +188 -0
  189. package/src/commands/auth/index.ts +16 -10
  190. package/src/commands/auth/login.ts +30 -23
  191. package/src/commands/auth/whoami.ts +16 -1
  192. package/src/commands/coding-agent.ts +33 -0
  193. package/src/commands/config/backend.ts +20 -6
  194. package/src/commands/embedding.ts +209 -0
  195. package/src/commands/example.ts +146 -0
  196. package/src/commands/help.ts +16 -3
  197. package/src/commands/load-test/burst.ts +291 -0
  198. package/src/commands/load-test/index.ts +183 -0
  199. package/src/commands/load-test/report.ts +302 -0
  200. package/src/commands/mcp-server.ts +5 -5
  201. package/src/commands/setup.ts +76 -2
  202. package/src/commands/up.ts +76 -10
  203. package/src/commands/usage.ts +55 -2
  204. package/src/config/config.ts +18 -8
  205. package/src/config/index.ts +1 -0
  206. package/src/config/resolve.ts +5 -3
  207. package/src/errors/classify.ts +10 -1
  208. package/src/errors/cli-exit-error.ts +6 -2
  209. package/src/errors/handle.ts +74 -8
  210. package/src/local/daemon/components.ts +66 -2
  211. package/src/local/daemon/host.ts +6 -2
  212. package/src/local/daemon/launch.ts +51 -16
  213. package/src/local/daemon/types.ts +9 -1
  214. package/src/local/key-check.ts +61 -0
  215. package/src/local/model-key-step.ts +164 -0
  216. package/src/local/setup/prompt.ts +22 -18
  217. package/src/local/setup/wizard.ts +45 -18
  218. package/src/local/state/lock.ts +116 -35
  219. package/src/local/state/pidfile.ts +14 -3
  220. package/src/program.ts +10 -0
  221. package/src/resources/get.ts +1 -1
  222. package/src/resources/run/stream.ts +2 -1
  223. package/src/resources/stream/render-plaintext.ts +20 -2
  224. package/src/resources/usage.ts +42 -0
  225. package/src/runtime.ts +17 -1
  226. package/auth/auth0.d.ts +0 -19
  227. package/auth/auth0.d.ts.map +0 -1
  228. package/auth/auth0.js +0 -39
  229. package/auth/auth0.js.map +0 -1
  230. package/src/auth/auth0.ts +0 -43
@@ -0,0 +1,28 @@
1
+ import type { Command } from "commander";
2
+ import type { Organization } from "@stigmer/apis/ai/stigmer/tenancy/organization/v1/api_pb";
3
+ import { IamRole } from "@stigmer/apis/ai/stigmer/iam/v1/enum_pb";
4
+ import { type OutputFlags, CommandResult } from "../output/index.js";
5
+ interface SetFlags extends OutputFlags {
6
+ createAccountsOnSignIn?: string;
7
+ signInRole?: string;
8
+ }
9
+ /** The two settings `set` changes, as they stand or should stand. */
10
+ export interface SignInSettings {
11
+ readonly createAccountsOnSignIn: boolean;
12
+ readonly signInRole: IamRole;
13
+ }
14
+ export declare function registerEmbedding(program: Command): void;
15
+ /** The flags as settings to apply; an omitted flag is undefined. Throws on a word it does not know. */
16
+ export declare function parseSetFlags(options: SetFlags): Partial<SignInSettings>;
17
+ /**
18
+ * The settings after a change: a role needs account creation on, so a role
19
+ * asked for turns it on when the flag left it unsaid, and turning it off
20
+ * clears the role. Pure.
21
+ */
22
+ export declare function nextSettings(current: SignInSettings, wanted: Partial<SignInSettings>): SignInSettings;
23
+ /** The two settings as the organization holds them. */
24
+ export declare function signInSettingsOf(organization: Organization): SignInSettings;
25
+ /** The settings as a person reads them. Pure. */
26
+ export declare function embeddingResult(organization: Organization, message: string): CommandResult;
27
+ export {};
28
+ //# sourceMappingURL=embedding.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../src/commands/embedding.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAIlE,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AAGnF,UAAU,QAAS,SAAQ,WAAW;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6CxD;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAUrG;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,CAM3E;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAwB1F"}
@@ -0,0 +1,170 @@
1
+ // `stigmer embedding [set]` — how people sign in to the organization from your own app.
2
+ //
3
+ // embedding the settings as they stand
4
+ // embedding set [--create-accounts-on-sign-in on|off]
5
+ // [--sign-in-role member|admin|viewer|none]
6
+ //
7
+ // When your app's backend mints a token for one of its users (the token
8
+ // route `stigmer app-handover` writes), the server makes that person's
9
+ // account on their first sign-in only while account creation is on, and
10
+ // gives it the sign-in role. `set` changes those two and keeps everything
11
+ // else as it stands (the allowed origins and the vaults), the rule the
12
+ // console's In your app tab follows, since the server replaces the settings
13
+ // whole (`updateEmbedding`). A role needs account creation on, so turning it
14
+ // off clears the role. Only the organization's admins may change them; the
15
+ // refusal says so.
16
+ import { IamRole } from "@stigmer/apis/ai/stigmer/iam/v1/enum_pb";
17
+ import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
18
+ import { Code } from "@connectrpc/connect";
19
+ import { CliExitError, ExitCode, UsageError, classify } from "../errors/index.js";
20
+ import { CommandResult, renderResult } from "../output/index.js";
21
+ import { addResultFlags, globalOrg, resultFormat } from "./shared.js";
22
+ const SET_ORG_WITH = ["stigmer embedding --org <org>", "stigmer config context set --org <org>"];
23
+ /** The roles `--sign-in-role` takes, by the word a person types. */
24
+ const ROLES = new Map([
25
+ ["member", IamRole.member],
26
+ ["admin", IamRole.admin],
27
+ ["viewer", IamRole.viewer],
28
+ ["none", IamRole.iam_role_unspecified],
29
+ ]);
30
+ export function registerEmbedding(program) {
31
+ const group = program
32
+ .command("embedding")
33
+ .description("how people sign in to the organization from your own app: account creation and their role")
34
+ .action(async (options, command) => {
35
+ const { organization } = await openSession(command);
36
+ renderResult(embeddingResult(organization, "Embedding settings"), resultFormat(options));
37
+ });
38
+ addResultFlags(group);
39
+ const set = group
40
+ .command("set")
41
+ .description("change account creation on sign-in and the role it gives, keeping origins and vaults (organization admins)")
42
+ .option("--create-accounts-on-sign-in <on|off>", "make a person's account the first time your app signs them in")
43
+ .option("--sign-in-role <role>", "the role those accounts get: member, admin, viewer or none")
44
+ .action(async (options, command) => {
45
+ const format = resultFormat(options);
46
+ const wanted = parseSetFlags(options);
47
+ const { stigmer, organization } = await openSession(command);
48
+ const next = nextSettings(signInSettingsOf(organization), wanted);
49
+ const { create } = await import("@bufbuild/protobuf");
50
+ const { UpdateOrganizationEmbeddingInputSchema } = await import("@stigmer/apis/ai/stigmer/tenancy/organization/v1/io_pb");
51
+ const { OrganizationEmbeddingSchema } = await import("@stigmer/apis/ai/stigmer/tenancy/organization/v1/spec_pb");
52
+ const current = organization.spec?.embedding;
53
+ let updated;
54
+ try {
55
+ updated = await stigmer.organization.updateEmbedding(create(UpdateOrganizationEmbeddingInputSchema, {
56
+ orgId: organization.metadata?.id ?? "",
57
+ embedding: create(OrganizationEmbeddingSchema, {
58
+ allowedOrigins: [...(current?.allowedOrigins ?? [])],
59
+ vaults: [...(current?.vaults ?? [])],
60
+ createAccountsOnSignIn: next.createAccountsOnSignIn,
61
+ signInRole: next.signInRole,
62
+ }),
63
+ }));
64
+ }
65
+ catch (err) {
66
+ throw refusalOf(err) ?? err;
67
+ }
68
+ renderResult(embeddingResult(updated, "Embedding settings saved"), format);
69
+ });
70
+ addResultFlags(set);
71
+ }
72
+ /** The flags as settings to apply; an omitted flag is undefined. Throws on a word it does not know. */
73
+ export function parseSetFlags(options) {
74
+ const out = {};
75
+ if (options.createAccountsOnSignIn !== undefined) {
76
+ const word = options.createAccountsOnSignIn.trim().toLowerCase();
77
+ if (word !== "on" && word !== "off") {
78
+ throw new UsageError(`--create-accounts-on-sign-in takes on or off, not "${options.createAccountsOnSignIn}"`);
79
+ }
80
+ out.createAccountsOnSignIn = word === "on";
81
+ }
82
+ if (options.signInRole !== undefined) {
83
+ const word = options.signInRole.trim().toLowerCase();
84
+ const role = ROLES.get(word);
85
+ if (role === undefined) {
86
+ throw new UsageError(word === "owner"
87
+ ? "the sign-in role cannot be owner\n\nOwnership is given by hand. Use member, admin, viewer or none."
88
+ : `unknown role "${options.signInRole}"\n\nUse member, admin, viewer or none.`);
89
+ }
90
+ out.signInRole = role;
91
+ }
92
+ if (out.createAccountsOnSignIn === undefined && out.signInRole === undefined) {
93
+ throw new UsageError("nothing to change\n\nPass --create-accounts-on-sign-in on|off, --sign-in-role <role>, or both.");
94
+ }
95
+ return out;
96
+ }
97
+ /**
98
+ * The settings after a change: a role needs account creation on, so a role
99
+ * asked for turns it on when the flag left it unsaid, and turning it off
100
+ * clears the role. Pure.
101
+ */
102
+ export function nextSettings(current, wanted) {
103
+ const roleAsked = wanted.signInRole !== undefined && wanted.signInRole !== IamRole.iam_role_unspecified;
104
+ const create = wanted.createAccountsOnSignIn ?? (roleAsked ? true : current.createAccountsOnSignIn);
105
+ if (!create && roleAsked) {
106
+ throw new UsageError("a sign-in role needs account creation on\n\nOnly an account the sign-in makes gets the role. Drop --sign-in-role, or use --create-accounts-on-sign-in on.");
107
+ }
108
+ const role = create ? (wanted.signInRole ?? current.signInRole) : IamRole.iam_role_unspecified;
109
+ return { createAccountsOnSignIn: create, signInRole: role };
110
+ }
111
+ /** The two settings as the organization holds them. */
112
+ export function signInSettingsOf(organization) {
113
+ const embedding = organization.spec?.embedding;
114
+ return {
115
+ createAccountsOnSignIn: embedding?.createAccountsOnSignIn === true,
116
+ signInRole: embedding?.signInRole ?? IamRole.iam_role_unspecified,
117
+ };
118
+ }
119
+ /** The settings as a person reads them. Pure. */
120
+ export function embeddingResult(organization, message) {
121
+ const embedding = organization.spec?.embedding;
122
+ const settings = signInSettingsOf(organization);
123
+ const origins = embedding?.allowedOrigins ?? [];
124
+ const vaults = embedding?.vaults ?? [];
125
+ const role = roleWord(settings.signInRole);
126
+ const result = CommandResult.success(message).withData({
127
+ org: organization.metadata?.slug ?? "",
128
+ createAccountsOnSignIn: settings.createAccountsOnSignIn,
129
+ signInRole: role,
130
+ allowedOrigins: [...origins],
131
+ vaults: vaults.length,
132
+ });
133
+ result
134
+ .addSection("")
135
+ .field("Organization", organization.metadata?.slug ?? organization.metadata?.id ?? "")
136
+ .field("Accounts on sign-in", settings.createAccountsOnSignIn ? "made on a person's first sign-in" : "off: your app makes them first")
137
+ .field("Their role", settings.createAccountsOnSignIn ? role : "none")
138
+ .field("Allowed origins", origins.length === 0 ? "any (not checked)" : origins.join(", "))
139
+ .field("Vaults", vaults.length === 0 ? "none" : `${vaults.length}`);
140
+ if (!settings.createAccountsOnSignIn) {
141
+ result.hint("Let your app's users in on their first sign-in: stigmer embedding set --create-accounts-on-sign-in on --sign-in-role member");
142
+ }
143
+ return result;
144
+ }
145
+ function roleWord(role) {
146
+ for (const [word, value] of ROLES)
147
+ if (value === role)
148
+ return word;
149
+ // A role `set` does not offer (an organization that holds one from before): its own name.
150
+ return IamRole[role] ?? "none";
151
+ }
152
+ /** A refusal in plain words, or undefined for any other failure. */
153
+ function refusalOf(err) {
154
+ if (classify(err)?.code === Code.PermissionDenied) {
155
+ return new CliExitError("only the organization's admins can change how people sign in from your app", ExitCode.Auth, ["Ask an admin to run: stigmer embedding set ..."], { cause: err });
156
+ }
157
+ return undefined;
158
+ }
159
+ async function openSession(command) {
160
+ const [{ connectBackend }, { currentOrganization }] = await Promise.all([
161
+ import("../backend.js"),
162
+ import("../client/current-organization.js"),
163
+ ]);
164
+ const client = connectBackend();
165
+ ensureAuthenticated(client.config);
166
+ const org = resolveOrganization(client.config, globalOrg(command));
167
+ const organization = await currentOrganization(client.stigmer, org, SET_ORG_WITH);
168
+ return { stigmer: client.stigmer, organization };
169
+ }
170
+ //# sourceMappingURL=embedding.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"embedding.js","sourceRoot":"","sources":["../src/commands/embedding.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { Command } from "commander";
2
+ import type { Example, ExampleSkill } from "@stigmer/examples";
3
+ import { CommandResult } from "../output/index.js";
4
+ /** Where the output of a first run goes, as the guide's step 4 names it. */
5
+ export declare const RUN_OUTPUT_DIR = "stigmer-output";
6
+ export declare function registerExample(program: Command): void;
7
+ /** The list a person reads: each example's job, then the skills. Pure. */
8
+ export declare function exampleListResult(examples: readonly Example[], skills: readonly ExampleSkill[]): CommandResult;
9
+ /** Write an example's manifest and samples into `dir`, refusing to overwrite unless `force`. */
10
+ export declare function writeExample(example: Example, dir: string, force: boolean): CommandResult;
11
+ /** Write a skill's SKILL.md into `dir`, refusing to overwrite unless `force`. */
12
+ export declare function writeSkill(skill: ExampleSkill, dir: string, force: boolean): CommandResult;
13
+ //# sourceMappingURL=example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/commands/example.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAoB,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AAOnF,4EAA4E;AAC5E,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoCtD;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,aAAa,CA2B9G;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAWzF;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAO1F"}
@@ -0,0 +1,126 @@
1
+ // `stigmer example list|get` — Stigmer's example agents, as files in your repository.
2
+ //
3
+ // example list every example: the job, what goes in, what comes back;
4
+ // then the ready-made skills
5
+ // example get <id> [dir] write an example's manifest and samples into dir
6
+ // (default stigmer/<id>), or a skill's SKILL.md
7
+ // (default stigmer/skills/<id>)
8
+ //
9
+ // The list is `@stigmer/examples`, the one the console's first question and
10
+ // its Make it yours tab read, so every door offers the same agents with the
11
+ // same words. `get` writes the manifest people would download and the sample
12
+ // files a first run attaches, then says the two commands that make the agent
13
+ // and run it once on the samples (`stigmer apply -f`, `stigmer run --attach`).
14
+ // An agent made from an example keeps the example's slug, which is how the
15
+ // console's journey knows it.
16
+ //
17
+ // It never overwrites: a file already there is refused unless `--force`, so a
18
+ // manifest a person (or their coding agent) has edited is not lost.
19
+ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
20
+ import { join, relative, resolve } from "node:path";
21
+ import { CliExitError, ExitCode } from "../errors/index.js";
22
+ import { CommandResult, renderResult } from "../output/index.js";
23
+ import { addResultFlags, resultFormat } from "./shared.js";
24
+ /** Where the output of a first run goes, as the guide's step 4 names it. */
25
+ export const RUN_OUTPUT_DIR = "stigmer-output";
26
+ export function registerExample(program) {
27
+ const group = program
28
+ .command("example")
29
+ .description("the example agents and skills, written into your repository as files");
30
+ const list = group
31
+ .command("list")
32
+ .description("list the example agents (the job, what goes in, what comes back) and the ready-made skills")
33
+ .action(async (options) => {
34
+ const { EXAMPLES, SKILLS } = await import("@stigmer/examples");
35
+ renderResult(exampleListResult(EXAMPLES, SKILLS), resultFormat(options));
36
+ });
37
+ addResultFlags(list);
38
+ const get = group
39
+ .command("get <id> [dir]")
40
+ .description("write an example's manifest and sample files (or a skill's SKILL.md) into dir")
41
+ .option("-f, --force", "overwrite files that are already there")
42
+ .action(async (id, dir, options) => {
43
+ const { exampleById, skillById, EXAMPLES, SKILLS } = await import("@stigmer/examples");
44
+ const example = exampleById(id);
45
+ const skill = example === undefined ? skillById(id) : undefined;
46
+ if (example === undefined && skill === undefined) {
47
+ throw new CliExitError(`no example or skill named "${id}"`, ExitCode.Usage, [
48
+ `Examples: ${EXAMPLES.map((e) => e.id).join(", ")}`,
49
+ `Skills: ${SKILLS.map((s) => s.id).join(", ")}`,
50
+ "See them with: stigmer example list",
51
+ ]);
52
+ }
53
+ const result = example !== undefined
54
+ ? writeExample(example, dir ?? join("stigmer", example.id), options.force === true)
55
+ : writeSkill(skill, dir ?? join("stigmer", "skills", skill.id), options.force === true);
56
+ renderResult(result, resultFormat(options));
57
+ });
58
+ addResultFlags(get);
59
+ }
60
+ /** The list a person reads: each example's job, then the skills. Pure. */
61
+ export function exampleListResult(examples, skills) {
62
+ const result = CommandResult.success(`${examples.length} example agents`).withData({
63
+ examples: examples.map((e) => ({
64
+ id: e.id,
65
+ name: e.name,
66
+ for: e.for,
67
+ gives: e.gives,
68
+ gets: e.gets,
69
+ agent: e.agent.slug,
70
+ })),
71
+ skills: skills.map((s) => ({ id: s.id, name: s.name, description: s.description })),
72
+ });
73
+ for (const example of examples) {
74
+ result
75
+ .addSection(`${example.id} — ${example.name}`)
76
+ .field("For", example.for.replace(/^For /, ""))
77
+ .field("Gives", example.gives)
78
+ .field("Gets", example.gets)
79
+ .field("Agent", example.agent.slug);
80
+ }
81
+ if (skills.length > 0) {
82
+ const section = result.addSection("Skills");
83
+ for (const skill of skills)
84
+ section.field(skill.id, skill.name);
85
+ }
86
+ return result
87
+ .hint("Write one into this repository: stigmer example get <id>")
88
+ .hint("Or describe your own agent in a manifest and: stigmer apply -f <file>");
89
+ }
90
+ /** Write an example's manifest and samples into `dir`, refusing to overwrite unless `force`. */
91
+ export function writeExample(example, dir, force) {
92
+ const files = [example.manifest, ...example.samples.map((s) => ({ name: s.name, text: s.text }))];
93
+ const written = writeFiles(dir, files, force);
94
+ const shown = displayPath(dir);
95
+ const attach = example.samples.map((s) => `--attach ${join(shown, s.name)}`).join(" ");
96
+ return CommandResult.success(`Wrote ${example.name} into ${shown}`)
97
+ .withData({ dir: shown, files: written, agent: example.agent.slug })
98
+ .hint(`Make the agent: stigmer apply -f ${join(shown, example.manifest.name)}`)
99
+ .hint(`Run it once on the ${example.sampleName}: stigmer run ${example.agent.slug} -m ${JSON.stringify(example.message)} ${attach} --download ${RUN_OUTPUT_DIR}/`);
100
+ }
101
+ /** Write a skill's SKILL.md into `dir`, refusing to overwrite unless `force`. */
102
+ export function writeSkill(skill, dir, force) {
103
+ const written = writeFiles(dir, [{ name: "SKILL.md", text: skill.text }], force);
104
+ const shown = displayPath(dir);
105
+ return CommandResult.success(`Wrote the ${skill.name} skill into ${shown}`)
106
+ .withData({ dir: shown, files: written, skill: skill.id })
107
+ .hint(`Push it to your organization: stigmer push skill ${shown}`)
108
+ .hint(`Then add it to an agent's skill_refs and apply the agent again.`);
109
+ }
110
+ function writeFiles(dir, files, force) {
111
+ const target = resolve(dir);
112
+ const existing = files.map((f) => join(target, f.name)).filter((path) => existsSync(path));
113
+ if (existing.length > 0 && !force) {
114
+ throw new CliExitError(`${existing.map(displayPath).join(", ")} ${existing.length === 1 ? "is" : "are"} already there`, ExitCode.Usage, ["Keep your copy, write somewhere else (stigmer example get <id> <dir>), or overwrite with --force."]);
115
+ }
116
+ mkdirSync(target, { recursive: true });
117
+ for (const file of files)
118
+ writeFileSync(join(target, file.name), file.text);
119
+ return files.map((f) => displayPath(join(target, f.name)));
120
+ }
121
+ /** A path as the person typed it: relative to where they stand when it is inside. */
122
+ function displayPath(path) {
123
+ const rel = relative(process.cwd(), resolve(path));
124
+ return rel === "" ? "." : rel.startsWith("..") ? resolve(path) : rel;
125
+ }
126
+ //# sourceMappingURL=example.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.js","sourceRoot":"","sources":["../src/commands/example.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/commands/help.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAA6C,KAAK,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AAEnH,qDAAqD;AACrD,eAAO,MAAM,WAAW,2GAA4G,CAAC;AAErI,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,yDAAyD;AACzD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAuC9D,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAsFpE,CAAC;AAEH,qGAAqG;AACrG,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAO/C,CAAC;AAEF,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAahD"}
1
+ {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/commands/help.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAA6C,KAAK,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AAEnH,qDAAqD;AACrD,eAAO,MAAM,WAAW,2GAA4G,CAAC;AAErI,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,yDAAyD;AACzD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CA4C9D,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CA8FpE,CAAC;AAEH,qGAAqG;AACrG,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAO/C,CAAC;AAEF,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAahD"}
package/commands/help.js CHANGED
@@ -22,6 +22,9 @@ export const COMMAND_GROUPS = {
22
22
  run: "Run agents",
23
23
  resume: "Run agents",
24
24
  runs: "Run agents",
25
+ "app-handover": "Run agents",
26
+ "coding-agent": "Run agents",
27
+ "load-test": "Run agents",
25
28
  get: "Your library",
26
29
  list: "Your library",
27
30
  search: "Your library",
@@ -35,6 +38,7 @@ export const COMMAND_GROUPS = {
35
38
  vault: "Your library",
36
39
  file: "Your library",
37
40
  connect: "Your library",
41
+ example: "Your library",
38
42
  push: "Packages",
39
43
  install: "Packages",
40
44
  marketplace: "Packages",
@@ -51,6 +55,7 @@ export const COMMAND_GROUPS = {
51
55
  auth: "Account and access",
52
56
  apikey: "Account and access",
53
57
  "service-account": "Account and access",
58
+ embedding: "Account and access",
54
59
  "provider-key": "Account and access",
55
60
  "access-history": "Account and access",
56
61
  usage: "Account and access",
@@ -63,15 +68,17 @@ export const HELP_EXAMPLES = new Map([
63
68
  ["stigmer access-history export", [{ say: "everything, oldest first, one JSON object per line", run: "stigmer access-history export > access-history.jsonl" }, { say: "only what came after the last entry you hold", run: "stigmer access-history export --after 42 >> access-history.jsonl" }]],
64
69
  ["stigmer access-history list", [{ say: "the newest 50 changes", run: "stigmer access-history list" }, { say: "the newest 200, as JSON", run: "stigmer access-history list --limit 200 -o json" }]],
65
70
  ["stigmer agent quality", [{ say: "how the agent's runs were graded over the last 30 days, per version", run: "stigmer agent quality variance-reporter" }, { say: "the last week's failed grades, newest first", run: "stigmer agent quality variance-reporter --days 7 --flagged --limit 50" }]],
66
- ["stigmer apikey create", [{ say: "create a new API key", run: "stigmer apikey create --name \"ci-pipeline\"" }, { say: "create a key that never expires", run: "stigmer apikey create --name \"automation\" --never-expires" }]],
71
+ ["stigmer apikey create", [{ say: "create a new API key", run: "stigmer apikey create --name \"ci-pipeline\"" }, { say: "create a key that never expires", run: "stigmer apikey create --name \"automation\" --never-expires" }, { say: "a key for your app's backend, saved to its env file and never printed", run: "stigmer apikey create --service-account app-backend --name my-app --save-to-env .env.local" }]],
72
+ ["stigmer app-handover", [{ say: "print the token route and chat for a Next.js app", run: "stigmer app-handover --stack nextjs --agent invoice-matcher" }, { say: "write them into the app you are in", run: "stigmer app-handover --stack node --agent invoice-matcher --write ." }]],
67
73
  ["stigmer apikey fingerprint", [{ say: "look up which key matches a raw token", run: "stigmer apikey fingerprint stk_abc123..." }]],
68
74
  ["stigmer apply", [{ say: "apply a single resource file", run: "stigmer apply -f agent.yaml" }, { say: "apply all resources in a directory", run: "stigmer apply -f ./manifests/" }]],
69
- ["stigmer auth login", [{ say: "log in to Stigmer Cloud", run: "stigmer auth login" }]],
75
+ ["stigmer auth login", [{ say: "sign in to the active backend's server in your browser", run: "stigmer auth login" }, { say: "where no browser opens here, sign in with a code on any device", run: "stigmer auth login --device" }]],
70
76
  ["stigmer auth logout", [{ say: "log out", run: "stigmer auth logout" }]],
71
77
  ["stigmer auth whoami", [{ say: "check who you're logged in as", run: "stigmer auth whoami" }]],
72
78
  ["stigmer channel disable", [{ say: "pause any channel (web, Slack or WhatsApp), keeping its configuration", run: "stigmer channel disable acme-corp/variance-reporter-slack" }]],
73
79
  ["stigmer channel enable", [{ say: "turn it back on", run: "stigmer channel enable acme-corp/variance-reporter-slack" }]],
74
80
  ["stigmer channel link", [{ say: "turn on an Agent's chat link for your Organization's members", run: "stigmer channel link variance-reporter" }, { say: "make the link public and print the embed snippet", run: "stigmer channel link variance-reporter --audience public" }]],
81
+ ["stigmer coding-agent", [{ say: "print the guide your coding agent follows", run: "stigmer coding-agent" }]],
75
82
  ["stigmer completion", [{ say: "install permanently", run: "stigmer completion bash > /etc/bash_completion.d/stigmer" }]],
76
83
  ["stigmer config backend add", [{ say: "register a self-hosted server (mint the key with `stigmer apikey create`)", run: "stigmer config backend add staging --endpoint stigmer.example.com:7234 --api-key stk_..." }]],
77
84
  ["stigmer config backend list", [{ say: "see what is configured", run: "stigmer config backend list" }]],
@@ -90,12 +97,17 @@ export const HELP_EXAMPLES = new Map([
90
97
  ["stigmer down", [{ say: "stop the local stack", run: "stigmer down" }]],
91
98
  ["stigmer down server", [{ say: "stop the whole stack, as stigmer down does", run: "stigmer down server" }]],
92
99
  ["stigmer download", [{ say: "download all outputs from a run", run: "stigmer download run run_01abc123" }, { say: "download to a specific directory", run: "stigmer download run run_01abc123 --output-dir ./results/" }]],
100
+ ["stigmer embedding", [{ say: "how people sign in to your organization from your app", run: "stigmer embedding" }]],
101
+ ["stigmer embedding set", [{ say: "make an app user's account on their first sign-in, as a Member", run: "stigmer embedding set --create-accounts-on-sign-in on --sign-in-role member" }]],
93
102
  ["stigmer eval cancel", [{ say: "cancel a running eval run", run: "stigmer eval cancel evr_01abc123" }]],
94
103
  ["stigmer eval run", [{ say: "a plugin's own cases on the built-in assistant, with and without it", run: "stigmer eval run --plugin thermos" }, { say: "the cases of every plugin the agent attaches, on the agent", run: "stigmer eval run --agent variance-reporter" }, { say: "the cases of an Eval pushed with stigmer push eval, at its stable version", run: "stigmer eval run --agent variance-reporter --eval variance-reporter-evals@stable" }, { say: "the plugin's cases on the agent, with and without the plugin", run: "stigmer eval run --agent variance-reporter --plugin payroll" }]],
104
+ ["stigmer example get", [{ say: "write an example's manifest and samples into stigmer/invoice-match", run: "stigmer example get invoice-match" }, { say: "write a ready-made skill to push", run: "stigmer example get spreadsheet-export" }]],
105
+ ["stigmer example list", [{ say: "see the example agents and skills", run: "stigmer example list" }]],
95
106
  ["stigmer file upload", [{ say: "upload a spreadsheet to reuse, and see the id it is named by", run: "stigmer file upload q3-ledger.xlsx" }, { say: "upload into a conversation you already have", run: "stigmer file upload notes.md --session ses_01abc123" }]],
96
107
  ["stigmer get", [{ say: "get an agent by slug", run: "stigmer get agent my-agent" }, { say: "get by org-qualified slug", run: "stigmer get agent acme-corp/variance-reporter" }]],
97
108
  ["stigmer install", [{ say: "install from the official catalogue by name", run: "stigmer install linear" }, { say: "install from a source you added, naming it", run: "stigmer install acme-plugins/thermos" }]],
98
109
  ["stigmer list", [{ say: "list all agents", run: "stigmer list agents" }, { say: "list available resource types", run: "stigmer list types" }]],
110
+ ["stigmer load-test", [{ say: "start 25 agents at once on the active server", run: "stigmer load-test --agents 25" }, { say: "a bigger burst on a cheaper model, as JSON for a script", run: "stigmer load-test --agents 100 --model claude-haiku-4-5 --max-usd 2 -o json > burst.json" }]],
99
111
  ["stigmer logs", [{ say: "follow all components live (tail snapshot first)", run: "stigmer logs" }, { say: "show the last 100 lines and exit", run: "stigmer logs --no-follow --tail 100" }]],
100
112
  ["stigmer marketplace add", [{ say: "add your company's catalogue (a public GitHub repository with a marketplace file)", run: "stigmer marketplace add acme/agent-plugins" }, { say: "add a repository at a branch or tag, or from its URL", run: "stigmer marketplace add acme/agent-plugins@main" }]],
101
113
  ["stigmer marketplace list", [{ say: "see what is configured, and what one offers", run: "stigmer marketplace list" }]],
@@ -127,7 +139,7 @@ export const HELP_EXAMPLES = new Map([
127
139
  ["stigmer service-account delete", [{ say: "delete one; every key it has stops working at once", run: "stigmer service-account delete ci-deploy" }]],
128
140
  ["stigmer service-account keys", [{ say: "list one's API keys; revoke one with: stigmer delete apikey <id>", run: "stigmer service-account keys ci-deploy" }]],
129
141
  ["stigmer service-account list", [{ say: "list the Organization's service accounts, newest first", run: "stigmer service-account list" }]],
130
- ["stigmer setup", [{ say: "interactive setup", run: "stigmer setup" }, { say: "non-interactive: configure Anthropic", run: "stigmer setup --provider anthropic --api-key sk-ant-xxx" }]],
142
+ ["stigmer setup", [{ say: "interactive setup", run: "stigmer setup" }, { say: "non-interactive: configure Anthropic", run: "stigmer setup --provider anthropic --api-key sk-ant-xxx" }, { say: "the key through stdin, kept out of history and transcripts", run: "stigmer setup --api-key-stdin < anthropic.key" }]],
131
143
  ["stigmer status", [{ say: "show component health and LLM configuration", run: "stigmer status" }, { say: "machine-readable status for scripts", run: "stigmer status --json" }]],
132
144
  ["stigmer tag", [{ say: "tag an agent version as stable, by the short hash the history prints", run: "stigmer tag agent acme-corp/variance-reporter 3f8a1c0e9b7d stable" }, { say: "the same, by its full 64-character hash", run: "stigmer tag agent acme-corp/variance-reporter 3f8a1c0e9b7d2a4c6e5f1b3d9a7c0e2f4b6d8a1c3e5f7b9d0a2c4e6f8b1d3a5c stable" }]],
133
145
  ["stigmer up", [{ say: "start the full local stack (server, runner, Temporal)", run: "stigmer up" }]],
@@ -135,6 +147,7 @@ export const HELP_EXAMPLES = new Map([
135
147
  ["stigmer usage agent", [{ say: "view agent usage for a date range", run: "stigmer usage agent agt-01abc123 --from 2026-03-01 --to 2026-03-31" }]],
136
148
  ["stigmer usage hours", [{ say: "view the organization's agent hours (Stigmer Cloud)", run: "stigmer usage hours" }]],
137
149
  ["stigmer usage org", [{ say: "view organization-wide usage", run: "stigmer usage org --from 2026-03-01 --to 2026-03-31" }]],
150
+ ["stigmer usage onboarding", [{ say: "see where last week's new organizations stopped (platform operators)", run: "stigmer usage onboarding" }]],
138
151
  ["stigmer usage session", [{ say: "view usage for a specific session", run: "stigmer usage session ses_01j9z3k8m2q4r6t8v0w2y4a6c8" }]],
139
152
  ["stigmer validate", [{ say: "validate a single file", run: "stigmer validate -f agent.yaml" }, { say: "validate all YAML files in a directory", run: "stigmer validate -f ./manifests/" }]],
140
153
  ["stigmer vault connect-link", [{ say: "make a one-time sign-in page whose login lands in a shared vault", run: "stigmer vault connect-link ledger-keys --address https://mcp.linear.app/mcp --return-url https://app.example.com/settings" }]],
@@ -1 +1 @@
1
- {"version":3,"file":"help.js","sourceRoot":"","sources":["../src/commands/help.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"help.js","sourceRoot":"","sources":["../src/commands/help.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ import type { Agent } from "@stigmer/apis/ai/stigmer/agentic/agent/v1/api_pb";
2
+ import type { Run } from "@stigmer/apis/ai/stigmer/agentic/run/v1/api_pb";
3
+ import { type AgentInput, type RunInput, type SessionEventsClient } from "@stigmer/client";
4
+ import type { Refusal, RunSighting } from "./report.js";
5
+ /** The slice of the client the engine calls. */
6
+ export interface LoadTestClient extends SessionEventsClient {
7
+ readonly agent: {
8
+ create(input: AgentInput): Promise<Agent>;
9
+ delete(id: string): Promise<unknown>;
10
+ };
11
+ readonly run: {
12
+ create(input: RunInput): Promise<Run>;
13
+ get(id: string): Promise<Run>;
14
+ terminate(input: {
15
+ id: string;
16
+ reason: string;
17
+ }): Promise<unknown>;
18
+ };
19
+ readonly session: SessionEventsClient["session"] & {
20
+ delete(id: string): Promise<unknown>;
21
+ };
22
+ }
23
+ /** How the burst stands, each time it changes. */
24
+ export interface BurstProgress {
25
+ readonly sent: number;
26
+ readonly started: number;
27
+ /** Admitted and not yet started: waiting for a sandbox, or still setting up. */
28
+ readonly waiting: number;
29
+ readonly refused: number;
30
+ }
31
+ export interface BurstOptions {
32
+ /** The organization the agent and the turns are made in ("" lets a single-organization server fill it). */
33
+ readonly org: string;
34
+ readonly agents: number;
35
+ /** The model every turn asks for; "" leaves the agent's default. */
36
+ readonly model: string;
37
+ readonly message: string;
38
+ /** Each turn's budget, `RunConfig.max_cost_usd`. */
39
+ readonly shareUsd: number;
40
+ /** How long to watch, from the burst, before calling a run still waiting. */
41
+ readonly waitMs: number;
42
+ /** Ctrl-C: stops every watch; the cleanup still runs. */
43
+ readonly signal: AbortSignal;
44
+ readonly onProgress?: (progress: BurstProgress) => void;
45
+ /** The agent's name suffix; random when absent (tests pin it). */
46
+ readonly nonce?: string;
47
+ }
48
+ /** What the burst saw, and what its cleanup could not delete. */
49
+ export interface BurstResult {
50
+ /** The agent's slug. */
51
+ readonly agent: string;
52
+ readonly sightings: readonly RunSighting[];
53
+ /** "<kind> <id>" for each thing the cleanup could not delete. */
54
+ readonly leftBehind: readonly string[];
55
+ /** Whether Ctrl-C ended the watch. */
56
+ readonly interrupted: boolean;
57
+ }
58
+ /** The one-line instructions the burst's agent runs: each turn stays tiny. */
59
+ export declare const AGENT_INSTRUCTIONS = "Reply with one word.";
60
+ /** Run the burst (module header). The agent's create throws through; everything after it is cleaned up. */
61
+ export declare function runBurst(client: LoadTestClient, options: BurstOptions): Promise<BurstResult>;
62
+ /** A refused create as its code word and the server's own sentence. */
63
+ export declare function refusalOf(err: unknown): Refusal;
64
+ //# sourceMappingURL=burst.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"burst.d.ts","sourceRoot":"","sources":["../../src/commands/load-test/burst.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kDAAkD,CAAC;AAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gDAAgD,CAAC;AAG1E,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,QAAQ,EACb,KAAK,mBAAmB,EAMzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,gDAAgD;AAChD,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,QAAQ,CAAC,KAAK,EAAE;QACd,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,GAAG,EAAE;QACZ,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,SAAS,CAAC,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACpE,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,GAAG;QACjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACtC,CAAC;CACH;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,2GAA2G;IAC3G,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IACxD,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AAazD,2GAA2G;AAC3G,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAgElG;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG/C"}