@finalai/agent-protocol 0.1.0

package/dist/modules/process-inspection.mjs

@@ -0,0 +1,83 @@
+import * as z from "zod";
+var ProcessInspectionOperation = /* @__PURE__ */ ((ProcessInspectionOperation2) => {
+  ProcessInspectionOperation2["Available"] = "available";
+  ProcessInspectionOperation2["List"] = "list";
+  ProcessInspectionOperation2["Detail"] = "detail";
+  ProcessInspectionOperation2["Stop"] = "stop";
+  return ProcessInspectionOperation2;
+})(ProcessInspectionOperation || {});
+const identity = { processId: z.string().min(1).max(256), bootId: z.string().min(1).max(256) };
+const pagination = {
+  cursor: z.string().max(1024).optional(),
+  limit: z.number().int().min(1).max(200).optional()
+};
+const processInspectionRequestSchema = z.discriminatedUnion("operation", [
+  z.strictObject({ operation: z.literal("available" /* Available */) }),
+  z.strictObject({ operation: z.literal("list" /* List */), ...pagination }),
+  z.strictObject({
+    operation: z.literal("detail" /* Detail */),
+    ...identity,
+    ...pagination
+  }),
+  z.strictObject({ operation: z.literal("stop" /* Stop */), ...identity })
+]);
+const inspectedProcessSchema = z.object({
+  id: z.string(),
+  bootId: z.string(),
+  command: z.string(),
+  leaderPid: z.number().nullable(),
+  state: z.string(),
+  keepsAwake: z.boolean(),
+  createdAtMs: z.number(),
+  updatedAtMs: z.number(),
+  endedAtMs: z.number().nullable(),
+  cpuUsec: z.number().nullable(),
+  memoryBytes: z.number().nullable(),
+  memoryPeakBytes: z.number().nullable(),
+  ioReadBytes: z.number().nullable(),
+  ioWriteBytes: z.number().nullable(),
+  processCount: z.number().nullable()
+});
+const inspectedProcessMemberSchema = z.object({
+  pid: z.number(),
+  startTicks: z.number().nullable(),
+  ppid: z.number(),
+  executable: z.string(),
+  argumentPreview: z.string(),
+  state: z.string(),
+  startedAtMs: z.number().nullable(),
+  cpuUsec: z.number().nullable(),
+  memoryBytes: z.number().nullable()
+});
+const processInspectionPageSchema = z.object({
+  status: z.string(),
+  processes: z.array(inspectedProcessSchema),
+  nextCursor: z.string().nullable()
+});
+const processInspectionDetailSchema = z.object({
+  process: inspectedProcessSchema,
+  descendants: z.array(inspectedProcessMemberSchema),
+  nextCursor: z.string().nullable(),
+  logs: z.object({
+    stdout: z.string(),
+    stderr: z.string(),
+    stdoutTruncated: z.boolean(),
+    stderrTruncated: z.boolean()
+  })
+});
+const processInspectionResultSchema = z.union([
+  z.object({ available: z.boolean(), canStop: z.boolean().optional() }),
+  processInspectionPageSchema,
+  processInspectionDetailSchema,
+  z.object({ stopped: z.boolean() })
+]);
+export {
+  ProcessInspectionOperation,
+  inspectedProcessMemberSchema,
+  inspectedProcessSchema,
+  processInspectionDetailSchema,
+  processInspectionPageSchema,
+  processInspectionRequestSchema,
+  processInspectionResultSchema
+};
+//# sourceMappingURL=process-inspection.mjs.map

package/dist/modules/process-inspection.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/process-inspection.ts"],
+  "sourcesContent": ["// Public mirror of the shared process inspection wire; this package depends only on Zod.\nimport * as z from 'zod';\n\nexport enum ProcessInspectionOperation {\n  Available = 'available',\n  List = 'list',\n  Detail = 'detail',\n  Stop = 'stop',\n}\n\nconst identity = { processId: z.string().min(1).max(256), bootId: z.string().min(1).max(256) };\n\nconst pagination = {\n  cursor: z.string().max(1024).optional(),\n  limit: z.number().int().min(1).max(200).optional(),\n};\n\nexport const processInspectionRequestSchema = z.discriminatedUnion('operation', [\n  z.strictObject({ operation: z.literal(ProcessInspectionOperation.Available) }),\n  z.strictObject({ operation: z.literal(ProcessInspectionOperation.List), ...pagination }),\n  z.strictObject({\n    operation: z.literal(ProcessInspectionOperation.Detail),\n    ...identity,\n    ...pagination,\n  }),\n  z.strictObject({ operation: z.literal(ProcessInspectionOperation.Stop), ...identity }),\n]);\n\nexport type ProcessInspectionRequestIface = z.infer<typeof processInspectionRequestSchema>;\n\n// Responses tolerate added fields and states from a newer backend.\nexport const inspectedProcessSchema = z.object({\n  id: z.string(),\n  bootId: z.string(),\n  command: z.string(),\n  leaderPid: z.number().nullable(),\n  state: z.string(),\n  keepsAwake: z.boolean(),\n  createdAtMs: z.number(),\n  updatedAtMs: z.number(),\n  endedAtMs: z.number().nullable(),\n  cpuUsec: z.number().nullable(),\n  memoryBytes: z.number().nullable(),\n  memoryPeakBytes: z.number().nullable(),\n  ioReadBytes: z.number().nullable(),\n  ioWriteBytes: z.number().nullable(),\n  processCount: z.number().nullable(),\n});\n\nexport type InspectedProcessIface = z.infer<typeof inspectedProcessSchema>;\n\nexport const inspectedProcessMemberSchema = z.object({\n  pid: z.number(),\n  startTicks: z.number().nullable(),\n  ppid: z.number(),\n  executable: z.string(),\n  argumentPreview: z.string(),\n  state: z.string(),\n  startedAtMs: z.number().nullable(),\n  cpuUsec: z.number().nullable(),\n  memoryBytes: z.number().nullable(),\n});\n\nexport const processInspectionPageSchema = z.object({\n  status: z.string(),\n  processes: z.array(inspectedProcessSchema),\n  nextCursor: z.string().nullable(),\n});\n\nexport const processInspectionDetailSchema = z.object({\n  process: inspectedProcessSchema,\n  descendants: z.array(inspectedProcessMemberSchema),\n  nextCursor: z.string().nullable(),\n  logs: z.object({\n    stdout: z.string(),\n    stderr: z.string(),\n    stdoutTruncated: z.boolean(),\n    stderrTruncated: z.boolean(),\n  }),\n});\n\nexport const processInspectionResultSchema = z.union([\n  z.object({ available: z.boolean(), canStop: z.boolean().optional() }),\n  processInspectionPageSchema,\n  processInspectionDetailSchema,\n  z.object({ stopped: z.boolean() }),\n]);\n\nexport type ProcessInspectionResultIface = z.infer<typeof processInspectionResultSchema>;\n\nexport type ProcessInspectionPageIface = z.infer<typeof processInspectionPageSchema>;\n\nexport type ProcessInspectionDetailIface = z.infer<typeof processInspectionDetailSchema>;\n"],
+  "mappings": "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",
+  "names": ["ProcessInspectionOperation"]
+}

package/dist/modules/tolerance.d.mts

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+/**
+ * What a client sees when a server sends an enum value its bundle predates.
+ * Shipped bundles outlive deploys, so every server-to-client enum resolves to
+ * this instead of failing the whole payload.
+ */
+export declare enum WireFallback {
+    Unrecognized = "unrecognized"
+}
+/** A string enum from the server; unknown or malformed values become `WireFallback.Unrecognized`. */
+export declare const tolerantStringEnum: <Members extends z.core.util.EnumLike>(members: Members) => z.ZodUnion<readonly [z.ZodEnum<Members>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+/** An integer enum from the server; unknown or malformed values become `fallback`. */
+export declare const tolerantIntegerEnum: <Members extends z.core.util.EnumLike>(members: Members, fallback: Members[keyof Members]) => z.ZodCatch<z.ZodEnum<Members>>;
+/**
+ * A tagged union from the server; a member whose tag the bundle predates parses
+ * to `{ kind: WireFallback.Unrecognized, ...rest }` instead of failing.
+ */
+export declare const tolerantTaggedUnion: <Options extends readonly [z.ZodObject, ...z.ZodObject[]], Fallback extends z.ZodType>(options: Options, fallback: Fallback) => z.ZodUnion<readonly [...Options, Fallback]>;

package/dist/modules/tolerance.mjs

@@ -0,0 +1,15 @@
+import * as z from "zod";
+var WireFallback = /* @__PURE__ */ ((WireFallback2) => {
+  WireFallback2["Unrecognized"] = "unrecognized";
+  return WireFallback2;
+})(WireFallback || {});
+const tolerantStringEnum = (members) => z.union([z.enum(members), z.unknown().transform(() => "unrecognized" /* Unrecognized */)]);
+const tolerantIntegerEnum = (members, fallback) => z.enum(members).catch(fallback);
+const tolerantTaggedUnion = (options, fallback) => z.union([...options, fallback]);
+export {
+  WireFallback,
+  tolerantIntegerEnum,
+  tolerantStringEnum,
+  tolerantTaggedUnion
+};
+//# sourceMappingURL=tolerance.mjs.map

package/dist/modules/tolerance.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tolerance.ts"],
+  "sourcesContent": ["import * as z from 'zod';\n\n/**\n * What a client sees when a server sends an enum value its bundle predates.\n * Shipped bundles outlive deploys, so every server-to-client enum resolves to\n * this instead of failing the whole payload.\n */\nexport enum WireFallback {\n  Unrecognized = 'unrecognized',\n}\n\n/** A string enum from the server; unknown or malformed values become `WireFallback.Unrecognized`. */\nexport const tolerantStringEnum = <Members extends z.core.util.EnumLike>(members: Members) =>\n  z.union([z.enum(members), z.unknown().transform((): WireFallback => WireFallback.Unrecognized)]);\n\n/** An integer enum from the server; unknown or malformed values become `fallback`. */\nexport const tolerantIntegerEnum = <Members extends z.core.util.EnumLike>(\n  members: Members,\n  fallback: Members[keyof Members],\n) => z.enum(members).catch(fallback);\n\n/**\n * A tagged union from the server; a member whose tag the bundle predates parses\n * to `{ kind: WireFallback.Unrecognized, ...rest }` instead of failing.\n */\nexport const tolerantTaggedUnion = <\n  Options extends readonly [z.ZodObject, ...z.ZodObject[]],\n  Fallback extends z.ZodType,\n>(\n  options: Options,\n  fallback: Fallback,\n) => z.union([...options, fallback]);\n"],
+  "mappings": "AAAA,YAAY,OAAO;AAOZ,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,kBAAe;AADL,SAAAA;AAAA,GAAA;AAKL,MAAM,qBAAqB,CAAuC,YACvE,EAAE,MAAM,CAAC,EAAE,KAAK,OAAO,GAAG,EAAE,QAAQ,EAAE,UAAU,MAAoB,iCAAyB,CAAC,CAAC;AAG1F,MAAM,sBAAsB,CACjC,SACA,aACG,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ;AAM5B,MAAM,sBAAsB,CAIjC,SACA,aACG,EAAE,MAAM,CAAC,GAAG,SAAS,QAAQ,CAAC;",
+  "names": ["WireFallback"]
+}

package/package.json

@@ -0,0 +1,121 @@
+{
+  "name": "@finalai/agent-protocol",
+  "version": "0.1.0",
+  "private": false,
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/modules/index.d.mts",
+      "import": "./dist/modules/index.mjs",
+      "default": "./dist/modules/index.mjs"
+    },
+    "./agent-platform": {
+      "types": "./dist/modules/agent-platform/index.d.mts",
+      "import": "./dist/modules/agent-platform/index.mjs",
+      "default": "./dist/modules/agent-platform/index.mjs"
+    },
+    "./package.json": "./package.json",
+    "./agent-platform/agents": {
+      "types": "./dist/modules/agent-platform/agents.d.mts",
+      "import": "./dist/modules/agent-platform/agents.mjs",
+      "default": "./dist/modules/agent-platform/agents.mjs"
+    },
+    "./agent-platform/build": {
+      "types": "./dist/modules/agent-platform/build.d.mts",
+      "import": "./dist/modules/agent-platform/build.mjs",
+      "default": "./dist/modules/agent-platform/build.mjs"
+    },
+    "./agent-platform/common": {
+      "types": "./dist/modules/agent-platform/common.d.mts",
+      "import": "./dist/modules/agent-platform/common.mjs",
+      "default": "./dist/modules/agent-platform/common.mjs"
+    },
+    "./agent-platform/conversation-schedules": {
+      "types": "./dist/modules/agent-platform/conversation-schedules.d.mts",
+      "import": "./dist/modules/agent-platform/conversation-schedules.mjs",
+      "default": "./dist/modules/agent-platform/conversation-schedules.mjs"
+    },
+    "./agent-platform/conversations": {
+      "types": "./dist/modules/agent-platform/conversations.d.mts",
+      "import": "./dist/modules/agent-platform/conversations.mjs",
+      "default": "./dist/modules/agent-platform/conversations.mjs"
+    },
+    "./agent-platform/enums": {
+      "types": "./dist/modules/agent-platform/enums.d.mts",
+      "import": "./dist/modules/agent-platform/enums.mjs",
+      "default": "./dist/modules/agent-platform/enums.mjs"
+    },
+    "./agent-platform/links": {
+      "types": "./dist/modules/agent-platform/links.d.mts",
+      "import": "./dist/modules/agent-platform/links.mjs",
+      "default": "./dist/modules/agent-platform/links.mjs"
+    },
+    "./agent-platform/people": {
+      "types": "./dist/modules/agent-platform/people.d.mts",
+      "import": "./dist/modules/agent-platform/people.mjs",
+      "default": "./dist/modules/agent-platform/people.mjs"
+    },
+    "./agent-platform/realtime": {
+      "types": "./dist/modules/agent-platform/realtime.d.mts",
+      "import": "./dist/modules/agent-platform/realtime.mjs",
+      "default": "./dist/modules/agent-platform/realtime.mjs"
+    },
+    "./agent-platform/sandboxes": {
+      "types": "./dist/modules/agent-platform/sandboxes.d.mts",
+      "import": "./dist/modules/agent-platform/sandboxes.mjs",
+      "default": "./dist/modules/agent-platform/sandboxes.mjs"
+    },
+    "./agent-platform/sessions": {
+      "types": "./dist/modules/agent-platform/sessions.d.mts",
+      "import": "./dist/modules/agent-platform/sessions.mjs",
+      "default": "./dist/modules/agent-platform/sessions.mjs"
+    },
+    "./json-rpc": {
+      "types": "./dist/modules/json-rpc.d.mts",
+      "import": "./dist/modules/json-rpc.mjs",
+      "default": "./dist/modules/json-rpc.mjs"
+    },
+    "./json": {
+      "types": "./dist/modules/json.d.mts",
+      "import": "./dist/modules/json.mjs",
+      "default": "./dist/modules/json.mjs"
+    },
+    "./process-inspection": {
+      "types": "./dist/modules/process-inspection.d.mts",
+      "import": "./dist/modules/process-inspection.mjs",
+      "default": "./dist/modules/process-inspection.mjs"
+    },
+    "./tolerance": {
+      "types": "./dist/modules/tolerance.d.mts",
+      "import": "./dist/modules/tolerance.mjs",
+      "default": "./dist/modules/tolerance.mjs"
+    },
+    "./base58": {
+      "types": "./dist/modules/base58.d.mts",
+      "import": "./dist/modules/base58.mjs",
+      "default": "./dist/modules/base58.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "zod": "4.6.5"
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/final-company/packages-typescript.git",
+    "directory": "packages/@finalai/agent-protocol"
+  }
+}