@elizaos/shared 2.0.0-alpha.538 → 2.0.3-beta.2

package/contracts/apps-lifecycle-routes.js

@@ -0,0 +1,204 @@
+/**
+ * Zod schemas for the apps-lifecycle HTTP routes
+ * (launch / install / stop / relaunch / create / overlay-presence /
+ * refresh). Same template as the rest: schema in shared, safeParse on
+ * server, infer types on client.
+ *
+ * Routes covered:
+ *   POST /api/apps/launch            body: { name }                  → AppLaunchResult
+ *   POST /api/apps/install           body: { name, version? }        → InstallAppResponse
+ *   POST /api/apps/stop              body: { name?, runId? }         → AppStopResult
+ *                                     (at least one of name/runId required)
+ *   POST /api/apps/relaunch          body: { name, runId?, verify? } → AppLaunchResult
+ *   POST /api/apps/create            body: { intent, editTarget? }   → CreateAppResponse
+ *   POST /api/apps/overlay-presence  body: { appName?: string|null } → OverlayPresenceResponse
+ *   POST /api/apps/refresh           (no body)                       → RefreshAppsResponse
+ *
+ * Response shapes for the routes that delegate to AppLaunchResult or
+ * AppStopResult (launch, stop, relaunch) are still defined by the
+ * TypeScript interfaces in `./apps.ts` — those tree types have not
+ * been migrated to zod yet and are out of scope for this module.
+ */
+import z from "zod";
+/** Request body shared by /launch and /install. */
+const NameOnlyRequestBase = z
+    .object({
+    name: z.string().min(1, "name is required"),
+})
+    .strict();
+/** Trims `name` to match the server's pre-zod normalisation. */
+const trimName = (value) => ({
+    ...value,
+    name: value.name.trim(),
+});
+export const PostLaunchAppRequestSchema = NameOnlyRequestBase.transform(trimName).pipe(z.object({ name: z.string().min(1, "name is required") }).strict());
+export const PostInstallAppRequestSchema = z
+    .object({
+    name: z.string().min(1, "name is required"),
+    version: z.string().min(1).optional(),
+})
+    .strict()
+    .transform((value) => ({
+    ...value,
+    name: value.name.trim(),
+    ...(value.version ? { version: value.version.trim() } : {}),
+}))
+    .pipe(z
+    .object({
+    name: z.string().min(1, "name is required"),
+    version: z.string().min(1).optional(),
+})
+    .strict());
+/**
+ * /stop accepts `{ name }`, `{ runId }`, or both — but at least one
+ * must be a non-empty string. The `.refine()` does the cross-field
+ * check the route used to do by hand.
+ */
+export const PostStopAppRequestSchema = z
+    .object({
+    name: z.string().min(1).optional(),
+    runId: z.string().min(1).optional(),
+})
+    .strict()
+    .refine((value) => (value.name && value.name.trim().length > 0) ||
+    (value.runId && value.runId.trim().length > 0), { message: "name or runId is required" })
+    .transform((value) => ({
+    ...(value.name ? { name: value.name.trim() } : {}),
+    ...(value.runId ? { runId: value.runId.trim() } : {}),
+}));
+/**
+ * /relaunch accepts the launch fields plus optional `runId` (used to
+ * stop a specific run before relaunching, instead of the broader
+ * "stop everything matching `name`" behaviour) and a `verify`
+ * boolean that triggers post-launch verification. The route already
+ * required `name` even when `runId` was supplied — so no
+ * cross-field refine like /stop has.
+ */
+export const PostRelaunchAppRequestSchema = z
+    .object({
+    name: z.string().min(1, "name is required"),
+    runId: z.string().min(1).optional(),
+    verify: z.boolean().optional(),
+})
+    .strict()
+    .transform((value) => ({
+    name: value.name.trim(),
+    ...(value.runId ? { runId: value.runId.trim() } : {}),
+    ...(typeof value.verify === "boolean" ? { verify: value.verify } : {}),
+}))
+    .pipe(z
+    .object({
+    name: z.string().min(1, "name is required"),
+    runId: z.string().min(1).optional(),
+    verify: z.boolean().optional(),
+})
+    .strict());
+/**
+ * /create maps onto the unified APP action — the `intent` is the
+ * natural-language prompt the orchestrator hands to the spawned coding
+ * sub-agent, and `editTarget` (when present) names an existing app to
+ * edit instead of scaffolding a new one. The handler used to require a
+ * non-empty trimmed intent by hand; the schema now does that, plus
+ * trims `editTarget` so empty strings round-trip back to "missing".
+ */
+export const PostCreateAppRequestSchema = z
+    .object({
+    intent: z.string().min(1, "intent is required"),
+    editTarget: z.string().min(1).optional(),
+})
+    .strict()
+    .transform((value) => ({
+    intent: value.intent.trim(),
+    ...(value.editTarget ? { editTarget: value.editTarget.trim() } : {}),
+}))
+    .pipe(z
+    .object({
+    intent: z.string().min(1, "intent is required"),
+    editTarget: z.string().min(1).optional(),
+})
+    .strict());
+/**
+ * /overlay-presence is the UI's "which app is currently visible" ping.
+ * The route accepts a string, an explicit `null`, or omission — all of
+ * the latter two clear presence. Empty/whitespace strings collapse to
+ * null too, matching the handler's prior `trim().length > 0 ? trim : null`
+ * normalisation.
+ */
+export const PostOverlayPresenceRequestSchema = z
+    .object({
+    appName: z.union([z.string(), z.null()]).optional(),
+})
+    .strict()
+    .transform((value) => {
+    const raw = value.appName;
+    const trimmed = typeof raw === "string" ? raw.trim() : "";
+    return { appName: trimmed.length > 0 ? trimmed : null };
+});
+// ── Response schemas ─────────────────────────────────────────────────
+//
+// Only the inline ad-hoc shapes the handlers produce are modelled here.
+// Routes returning AppLaunchResult / AppStopResult (launch, relaunch,
+// stop) keep using the TS interfaces in `./apps.ts` — migrating those
+// tree types is a separate pass.
+/** /overlay-presence reply: `{ ok: true, appName: string | null }`. */
+export const PostOverlayPresenceResponseSchema = z
+    .object({
+    ok: z.literal(true),
+    appName: z.union([z.string().min(1), z.null()]),
+})
+    .strict();
+/** /create reply from the unified APP action. */
+export const PostCreateAppResponseSchema = z
+    .object({
+    success: z.boolean(),
+    text: z.string(),
+    messages: z.array(z.string()),
+    data: z.nullable(z.unknown()),
+})
+    .strict();
+/** /refresh reply — registry refresh count. */
+export const PostRefreshAppsResponseSchema = z
+    .object({
+    ok: z.literal(true),
+    count: z.number().int().nonnegative(),
+})
+    .strict();
+/**
+ * Component schema: install-progress event the installer streams as it
+ * walks through phases (download, extract, register, …). Mirrors the
+ * `InstallProgressLike` interface in
+ * `packages/agent/src/services/plugin-manager-types.ts`.
+ */
+export const InstallProgressEventSchema = z
+    .object({
+    phase: z.string(),
+    message: z.string(),
+    pluginName: z.string().optional(),
+})
+    .strict();
+/**
+ * /install reply, discriminated on `success`:
+ *   - success: full install metadata + replayed progress events
+ *   - failure: error + the progress events that were captured before
+ *     the failure
+ */
+export const PostInstallAppResponseSchema = z.discriminatedUnion("success", [
+    z
+        .object({
+        success: z.literal(true),
+        pluginName: z.string(),
+        version: z.string(),
+        installPath: z.string(),
+        requiresRestart: z.boolean(),
+        progress: z.array(InstallProgressEventSchema),
+    })
+        .strict(),
+    z
+        .object({
+        success: z.literal(false),
+        error: z.string().optional(),
+        progress: z.array(InstallProgressEventSchema),
+    })
+        .strict(),
+]);
+//# sourceMappingURL=apps-lifecycle-routes.js.map

package/contracts/apps-lifecycle-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-lifecycle-routes.js","sourceRoot":"","sources":["../../src/contracts/apps-lifecycle-routes.ts"],"names":[],"mappings":"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"}

package/contracts/apps-loading-routes.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Zod schemas for the apps-loading HTTP routes (the
+ * directory-load surface that produced the App Permissions PR's
+ * registry entries).
+ *
+ * Second migration in the typed-routes initiative — the App Permissions
+ * routes were the pilot in `./app-permissions-routes.ts`. The pattern
+ * (schema in shared, safeParse on server, infer types on client) is
+ * the same here; the only new wrinkle is `.refine()` for the
+ * absolute-path check that previously lived as a hand-rolled `if
+ * (!path.isAbsolute(directory))` guard in the route handler.
+ *
+ * Routes covered:
+ *   POST /api/apps/load-from-directory
+ *     body:    { directory: string }   (must be absolute)
+ *     200:     { ok: true, directory, registered: number,
+ *                items: [{slug, canonicalName}],
+ *                rejectedManifests: [{directory, packageName,
+ *                                      reason, path}] }
+ *     400:     directory missing / not absolute / not a string
+ *     503:     AppRegistryService not on runtime
+ *     500:     filesystem failure during scan
+ */
+import z from "zod";
+/**
+ * `path.isAbsolute` is platform-aware (POSIX vs Windows). Using it
+ * inside `.refine()` keeps the schema honest on whichever runtime
+ * the agent is on; declaring "must start with /" would silently miss
+ * on Windows.
+ */
+export declare const PostLoadFromDirectoryRequestSchema: z.ZodObject<{
+    directory: z.ZodString;
+}, z.core.$strict>;
+declare const RegisteredItemSchema: z.ZodObject<{
+    slug: z.ZodString;
+    canonicalName: z.ZodString;
+}, z.core.$strict>;
+declare const RejectedManifestSchema: z.ZodObject<{
+    directory: z.ZodString;
+    packageName: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    reason: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>;
+export declare const PostLoadFromDirectoryResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    directory: z.ZodString;
+    registered: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        canonicalName: z.ZodString;
+    }, z.core.$strict>>;
+    rejectedManifests: z.ZodArray<z.ZodObject<{
+        directory: z.ZodString;
+        packageName: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        reason: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PostLoadFromDirectoryRequest = z.infer<typeof PostLoadFromDirectoryRequestSchema>;
+export type PostLoadFromDirectoryResponse = z.infer<typeof PostLoadFromDirectoryResponseSchema>;
+export type LoadFromDirectoryRegisteredItem = z.infer<typeof RegisteredItemSchema>;
+export type LoadFromDirectoryRejectedManifest = z.infer<typeof RejectedManifestSchema>;
+export {};
+//# sourceMappingURL=apps-loading-routes.d.ts.map

package/contracts/apps-loading-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-loading-routes.d.ts","sourceRoot":"","sources":["../../src/contracts/apps-loading-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC;;kBASpC,CAAC;AAEZ,QAAA,MAAM,oBAAoB;;;kBAKf,CAAC;AAEZ,QAAA,MAAM,sBAAsB;;;;;kBAOjB,CAAC;AAEZ,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;kBAQrC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,mCAAmC,CAC3C,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,oBAAoB,CAC5B,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,sBAAsB,CAC9B,CAAC"}

package/contracts/apps-loading-routes.js

@@ -0,0 +1,65 @@
+/**
+ * Zod schemas for the apps-loading HTTP routes (the
+ * directory-load surface that produced the App Permissions PR's
+ * registry entries).
+ *
+ * Second migration in the typed-routes initiative — the App Permissions
+ * routes were the pilot in `./app-permissions-routes.ts`. The pattern
+ * (schema in shared, safeParse on server, infer types on client) is
+ * the same here; the only new wrinkle is `.refine()` for the
+ * absolute-path check that previously lived as a hand-rolled `if
+ * (!path.isAbsolute(directory))` guard in the route handler.
+ *
+ * Routes covered:
+ *   POST /api/apps/load-from-directory
+ *     body:    { directory: string }   (must be absolute)
+ *     200:     { ok: true, directory, registered: number,
+ *                items: [{slug, canonicalName}],
+ *                rejectedManifests: [{directory, packageName,
+ *                                      reason, path}] }
+ *     400:     directory missing / not absolute / not a string
+ *     503:     AppRegistryService not on runtime
+ *     500:     filesystem failure during scan
+ */
+import nodePath from "node:path";
+import z from "zod";
+/**
+ * `path.isAbsolute` is platform-aware (POSIX vs Windows). Using it
+ * inside `.refine()` keeps the schema honest on whichever runtime
+ * the agent is on; declaring "must start with /" would silently miss
+ * on Windows.
+ */
+export const PostLoadFromDirectoryRequestSchema = z
+    .object({
+    directory: z
+        .string()
+        .min(1, "directory is required")
+        .refine((value) => nodePath.isAbsolute(value), {
+        message: "directory must be an absolute path",
+    }),
+})
+    .strict();
+const RegisteredItemSchema = z
+    .object({
+    slug: z.string().min(1),
+    canonicalName: z.string().min(1),
+})
+    .strict();
+const RejectedManifestSchema = z
+    .object({
+    directory: z.string(),
+    packageName: z.union([z.string(), z.null()]),
+    reason: z.string(),
+    path: z.string(),
+})
+    .strict();
+export const PostLoadFromDirectoryResponseSchema = z
+    .object({
+    ok: z.literal(true),
+    directory: z.string(),
+    registered: z.number().int().nonnegative(),
+    items: z.array(RegisteredItemSchema),
+    rejectedManifests: z.array(RejectedManifestSchema),
+})
+    .strict();
+//# sourceMappingURL=apps-loading-routes.js.map

package/contracts/apps-loading-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-loading-routes.js","sourceRoot":"","sources":["../../src/contracts/apps-loading-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;SAC/B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;QAC7C,OAAO,EAAE,oCAAoC;KAC9C,CAAC;CACL,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,sBAAsB,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC;KACjD,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACpC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;CACnD,CAAC;KACD,MAAM,EAAE,CAAC"}

package/contracts/apps-runs-routes.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Zod schemas for the per-run steering HTTP routes:
+ *
+ *   POST /api/apps/runs/:runId/message   body: { content | message }
+ *   POST /api/apps/runs/:runId/control   body: { action: 'pause'|'resume' }
+ *
+ * The message route historically accepted either `content` or `message`
+ * as the field name (clients drifted, the handler tolerated both).
+ * The schema preserves that compatibility and normalises down to a
+ * single `content` field so the rest of the pipeline only sees one
+ * shape.
+ */
+import z from "zod";
+export declare const PostRunMessageRequestSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
+    content: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodTransform<{
+    content: string;
+}, {
+    content?: string | undefined;
+    message?: string | undefined;
+}>>, z.ZodObject<{
+    content: z.ZodString;
+}, z.core.$strict>>;
+export declare const PostRunControlRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        pause: "pause";
+        resume: "resume";
+    }>;
+}, z.core.$strict>;
+export type PostRunMessageRequest = z.infer<typeof PostRunMessageRequestSchema>;
+export type PostRunControlRequest = z.infer<typeof PostRunControlRequestSchema>;
+//# sourceMappingURL=apps-runs-routes.d.ts.map

package/contracts/apps-runs-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-runs-routes.d.ts","sourceRoot":"","sources":["../../src/contracts/apps-runs-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,eAAO,MAAM,2BAA2B;;;;;;;;;;mBAqBrC,CAAC;AAEJ,eAAO,MAAM,2BAA2B;;;;;kBAI7B,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/contracts/apps-runs-routes.js

@@ -0,0 +1,38 @@
+/**
+ * Zod schemas for the per-run steering HTTP routes:
+ *
+ *   POST /api/apps/runs/:runId/message   body: { content | message }
+ *   POST /api/apps/runs/:runId/control   body: { action: 'pause'|'resume' }
+ *
+ * The message route historically accepted either `content` or `message`
+ * as the field name (clients drifted, the handler tolerated both).
+ * The schema preserves that compatibility and normalises down to a
+ * single `content` field so the rest of the pipeline only sees one
+ * shape.
+ */
+import z from "zod";
+export const PostRunMessageRequestSchema = z
+    .object({
+    content: z.string().optional(),
+    message: z.string().optional(),
+})
+    .strict()
+    .transform((value) => {
+    const raw = typeof value.content === "string"
+        ? value.content
+        : typeof value.message === "string"
+            ? value.message
+            : "";
+    return { content: raw.trim() };
+})
+    .pipe(z
+    .object({
+    content: z.string().min(1, "content is required"),
+})
+    .strict());
+export const PostRunControlRequestSchema = z
+    .object({
+    action: z.enum(["pause", "resume"]),
+})
+    .strict();
+//# sourceMappingURL=apps-runs-routes.js.map

package/contracts/apps-runs-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-runs-routes.js","sourceRoot":"","sources":["../../src/contracts/apps-runs-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC;KACD,MAAM,EAAE;KACR,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,MAAM,GAAG,GACP,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QAC/B,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YACjC,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,EAAE,CAAC;IACX,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;AACjC,CAAC,CAAC;KACD,IAAI,CACH,CAAC;KACE,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;CAClD,CAAC;KACD,MAAM,EAAE,CACZ,CAAC;AAEJ,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC"}