@omercnet/paseo-omp 0.2.1 → 0.3.0

package/shared/hub.ts

@@ -23,7 +23,7 @@ export const HubProcessSchema = z.object({
   exitCode: z.number().nullable(),
 });
 export type HubProcess = z.infer<typeof HubProcessSchema>;
-const CwdSchema = z.string().min(1).max(4_096);
+export const OmpWorkspaceCwdSchema = z.string().min(1).max(4_096);
 const ProcessNameSchema = z
   .string()
   .min(1)
@@ -32,12 +32,12 @@ const ProcessNameSchema = z
 
 export const listHubProcesses = defineRpc({
   name: "paseo-omp.list-processes",
-  input: z.object({ cwd: CwdSchema }),
+  input: z.object({ cwd: OmpWorkspaceCwdSchema }),
   output: z.object({ processes: z.array(HubProcessSchema) }),
 });
 
 export const tailHubLog = defineRpc({
   name: "paseo-omp.tail-log",
-  input: z.object({ cwd: CwdSchema, name: ProcessNameSchema }),
+  input: z.object({ cwd: OmpWorkspaceCwdSchema, name: ProcessNameSchema }),
   output: z.object({ content: z.string(), truncated: z.boolean() }),
 });

package/shared/mcp.ts

@@ -0,0 +1,47 @@
+import { defineRpc } from "@getpaseo/plugin";
+import { z } from "zod";
+
+export const OMP_MCP_AUTH_TIMELINE_KIND = "omp-mcp-authorization";
+const OmpMcpAuthorizationUrlSchema = z
+  .string()
+  .max(16_384)
+  .refine((value) => {
+    try {
+      const url = new URL(value);
+      return (
+        (url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password
+      );
+    } catch {
+      return false;
+    }
+  }, "Authorization URL must be an HTTP URL without embedded credentials");
+
+export const ompMcpAuthorizationTimelineSchema = z.object({
+  url: OmpMcpAuthorizationUrlSchema,
+  instructions: z
+    .string()
+    .max(64 * 1024)
+    .optional(),
+  loopbackCallback: z.boolean(),
+  browserAuthorizationToken: z.string().uuid().optional(),
+});
+
+export type OmpMcpAuthorizationTimeline = z.infer<typeof ompMcpAuthorizationTimelineSchema>;
+export const openOmpMcpAuthorizationInPaseoBrowser = defineRpc({
+  name: "paseo-omp.open-mcp-authorization-in-browser",
+  input: z.object({ authorizationToken: z.string().uuid() }),
+  output: z.object({ opened: z.literal(true) }),
+});
+
+const OMP_MCP_SERVER_NAME = /^[a-zA-Z0-9_.:-]{1,100}$/u;
+
+export type OmpMcpServerAction = "test" | "reauth" | "enable" | "disable";
+
+export function buildOmpMcpServerCommand(
+  action: OmpMcpServerAction,
+  serverName: string,
+): string | undefined {
+  const name = serverName.trim();
+  if (!OMP_MCP_SERVER_NAME.test(name)) return;
+  return `/mcp ${action} ${name}`;
+}

package/shared/memory.ts

@@ -1,5 +1,6 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
+import { OmpStoreSchema } from "./omp-store";
 
 const CwdSchema = z.string().min(1).max(4_096);
 
@@ -15,7 +16,7 @@ export type OmpMemoryFact = z.infer<typeof OmpMemoryFactSchema>;
 
 export const listOmpMemory = defineRpc({
   name: "paseo-omp.list-memory",
-  input: z.object({ cwd: CwdSchema }),
+  input: z.object({ store: OmpStoreSchema.optional(), cwd: CwdSchema }),
   output: z.object({
     bank: z.string().nullable(),
     facts: z.array(OmpMemoryFactSchema),

package/shared/omp-config.ts

@@ -1,5 +1,7 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
+import { OmpWorkspaceCwdSchema } from "./hub";
+import { OmpStoreSchema } from "./omp-store";
 
 // Mirrors the safe, non-secret subset of omp's on-disk ~/.omp/agent/config.yml. That file is an
 // internal, unversioned config format owned by the omp harness (source: omp's
@@ -72,7 +74,9 @@ export type OmpConfig = z.infer<typeof OmpConfigSchema>;
 
 export const listOmpConfig = defineRpc({
   name: "paseo-omp.list-config",
-  input: z.object({}),
+  input: z
+    .object({ store: OmpStoreSchema.optional(), cwd: OmpWorkspaceCwdSchema.optional() })
+    .strict(),
   output: z.object({
     path: z.string(),
     available: z.boolean(),

package/shared/omp-plugins.ts

@@ -1,5 +1,7 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
+import { OmpWorkspaceCwdSchema } from "./hub";
+import { OmpStoreSchema } from "./omp-store";
 
 export const OMP_PLUGIN_LIMIT = 256;
 export const OMP_PLUGIN_ARGUMENT_LIMIT = 512;
@@ -72,6 +74,7 @@ export const OmpInstalledPluginSchema = z
     availableFeatures: z.array(z.string().min(1).max(128)).max(128),
     configurable: z.boolean(),
     ambiguous: z.boolean(),
+    configAmbiguous: z.boolean(),
     usesDefaultFeatures: z.boolean(),
   })
   .strict();
@@ -89,7 +92,9 @@ export type OmpPluginState = z.infer<typeof OmpPluginStateSchema>;
 
 export const listOmpPlugins = defineRpc({
   name: "paseo-omp.list-plugins",
-  input: z.object({}).strict(),
+  input: z
+    .object({ store: OmpStoreSchema.optional(), cwd: OmpWorkspaceCwdSchema.optional() })
+    .strict(),
   output: OmpPluginStateSchema,
 });
 
@@ -121,7 +126,13 @@ export type OmpPluginConfigState = z.infer<typeof OmpPluginConfigStateSchema>;
 
 export const inspectOmpPluginConfig = defineRpc({
   name: "paseo-omp.inspect-plugin-config",
-  input: z.object({ plugin: OmpPluginNameSchema }).strict(),
+  input: z
+    .object({
+      store: OmpStoreSchema.optional(),
+      plugin: OmpPluginNameSchema,
+      cwd: OmpWorkspaceCwdSchema.optional(),
+    })
+    .strict(),
   output: OmpPluginConfigStateSchema,
 });
 
@@ -151,6 +162,8 @@ export const OmpPluginConfigMutationSchema = z.discriminatedUnion("action", [
       plugin: OmpPluginNameSchema,
       key: OmpPluginConfigKeySchema,
       value: z.union([OmpPluginConfigStringValueSchema, z.number().finite(), z.boolean()]),
+      store: OmpStoreSchema.optional(),
+      cwd: OmpWorkspaceCwdSchema.optional(),
     })
     .strict(),
   z
@@ -158,6 +171,8 @@ export const OmpPluginConfigMutationSchema = z.discriminatedUnion("action", [
       action: z.literal("delete"),
       plugin: OmpPluginNameSchema,
       key: OmpPluginConfigKeySchema,
+      store: OmpStoreSchema.optional(),
+      cwd: OmpWorkspaceCwdSchema.optional(),
     })
     .strict(),
 ]);
@@ -176,38 +191,64 @@ export const mutateOmpPluginConfig = defineRpc({
 });
 
 const ScopedMutationShape = {
-  scope: z.literal("user").optional(),
+  scope: OmpPluginScopeSchema.optional(),
+  store: OmpStoreSchema.optional(),
+  cwd: OmpWorkspaceCwdSchema.optional(),
 };
-
-export const OmpPluginMutationSchema = z.discriminatedUnion("action", [
-  z
-    .object({
-      action: z.literal("install"),
-      source: OmpPluginInstallSourceSchema,
-      ...ScopedMutationShape,
-    })
-    .strict(),
-  z
-    .object({ action: z.literal("enable"), plugin: OmpPluginTargetSchema, ...ScopedMutationShape })
-    .strict(),
-  z
-    .object({ action: z.literal("disable"), plugin: OmpPluginTargetSchema, ...ScopedMutationShape })
-    .strict(),
-  z
-    .object({
-      action: z.literal("uninstall"),
-      plugin: OmpPluginTargetSchema,
-      ...ScopedMutationShape,
-    })
-    .strict(),
-  z
-    .object({
-      action: z.literal("upgrade"),
-      plugin: OmpMarketplacePluginIdSchema,
-      ...ScopedMutationShape,
-    })
-    .strict(),
-]);
+export const OmpPluginMutationSchema = z
+  .discriminatedUnion("action", [
+    z
+      .object({
+        action: z.literal("install"),
+        source: OmpPluginInstallSourceSchema,
+        ...ScopedMutationShape,
+      })
+      .strict(),
+    z
+      .object({
+        action: z.literal("enable"),
+        plugin: OmpPluginTargetSchema,
+        ...ScopedMutationShape,
+      })
+      .strict(),
+    z
+      .object({
+        action: z.literal("disable"),
+        plugin: OmpPluginTargetSchema,
+        ...ScopedMutationShape,
+      })
+      .strict(),
+    z
+      .object({
+        action: z.literal("uninstall"),
+        plugin: OmpPluginTargetSchema,
+        ...ScopedMutationShape,
+      })
+      .strict(),
+    z
+      .object({
+        action: z.literal("upgrade"),
+        plugin: OmpMarketplacePluginIdSchema,
+        ...ScopedMutationShape,
+      })
+      .strict(),
+  ])
+  .superRefine((input, context) => {
+    if (input.scope === "project" && input.cwd === undefined) {
+      context.addIssue({
+        code: "custom",
+        message: "Project-scoped plugin actions require a workspace",
+        path: ["cwd"],
+      });
+    }
+    if (input.action === "install" && input.scope === "project") {
+      context.addIssue({
+        code: "custom",
+        message: "Project-scoped installation is not supported through this API",
+        path: ["scope"],
+      });
+    }
+  });
 export type OmpPluginMutation = z.infer<typeof OmpPluginMutationSchema>;
 
 export const mutateOmpPlugin = defineRpc({

package/shared/omp-settings.ts

@@ -1,5 +1,7 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
+import { OmpWorkspaceCwdSchema } from "./hub";
+import { OmpStoreSchema } from "./omp-store";
 
 export const OMP_SETTINGS_CATALOG_VERSION = 1;
 
@@ -23,6 +25,7 @@ export const OmpSettingSchema = z
     value: z.unknown().optional(),
     redacted: z.boolean().optional(),
     configured: z.boolean().optional(),
+    workspaceOverride: z.boolean().optional(),
   })
   .strict();
 export type OmpSetting = z.infer<typeof OmpSettingSchema>;
@@ -167,7 +170,9 @@ export function formatOmpSettingLabel(path: string): string {
 
 export const listOmpSettings = defineRpc({
   name: "paseo-omp.list-settings",
-  input: z.object({}),
+  input: z
+    .object({ store: OmpStoreSchema.optional(), cwd: OmpWorkspaceCwdSchema.optional() })
+    .strict(),
   output: z.object({
     catalogVersion: z.literal(OMP_SETTINGS_CATALOG_VERSION),
     revision: z.string().optional(),
@@ -187,6 +192,8 @@ const OmpSettingChangeSchema = z.discriminatedUnion("operation", [
 export const updateOmpSettings = defineRpc({
   name: "paseo-omp.update-settings",
   input: z.object({
+    store: OmpStoreSchema.optional(),
+    cwd: OmpWorkspaceCwdSchema.optional(),
     revision: z.string(),
     changes: z.array(OmpSettingChangeSchema).min(1).max(100),
   }),

package/shared/omp-store.ts

@@ -0,0 +1,58 @@
+import { defineRpc } from "@getpaseo/plugin";
+import { z } from "zod";
+
+const OMP_PROFILE_NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/u;
+const WINDOWS_RESERVED_PROFILE = /^(?:CON|PRN|AUX|NUL|COM[0-9]|LPT[0-9])(?:\..*)?$/iu;
+
+export function isOmpProfileName(value: string): boolean {
+  return (
+    value !== "default" &&
+    !value.endsWith(".") &&
+    OMP_PROFILE_NAME.test(value) &&
+    !WINDOWS_RESERVED_PROFILE.test(value)
+  );
+}
+
+export const OmpProfileNameSchema = z.string().trim().refine(isOmpProfileName, {
+  message: "Invalid named OMP profile",
+});
+export const OmpStoreSchema = z
+  .object({
+    profile: OmpProfileNameSchema.optional(),
+    agentDir: z
+      .string()
+      .min(1)
+      .max(4096)
+      .refine((value) => !value.includes("\0"))
+      // Browser validation accepts absolute paths from any supported server OS;
+      // withOmpStore additionally applies node:path.isAbsolute on the server.
+      .refine(
+        (value) => /^(?:\/|[A-Za-z]:[\\/]|\\)/u.test(value),
+        "OMP agent directory must be absolute",
+      )
+      .optional(),
+  })
+  .strict()
+  .refine(
+    (value) => !(value.profile && value.agentDir),
+    "Choose a profile or agent directory, not both",
+  );
+export type OmpStore = z.infer<typeof OmpStoreSchema>;
+export const listOmpStores = defineRpc({
+  name: "paseo-omp.list-stores",
+  input: z.object({}).strict(),
+  output: z.object({ profiles: z.array(OmpProfileNameSchema).max(128) }),
+});
+
+export function storeForProvider(provider: string | undefined): OmpStore | undefined {
+  if (!provider?.startsWith("omp-plugin-")) return;
+  const profile = provider.slice("omp-plugin-".length);
+  return isOmpProfileName(profile) ? { profile } : undefined;
+}
+export function storeLabel(store?: OmpStore): string {
+  return store?.profile
+    ? `Profile: ${store.profile}`
+    : store?.agentDir
+      ? "Custom agent directory"
+      : "Daemon default store";
+}

package/shared/provider-diagnostics.ts

@@ -1,5 +1,7 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
+import { OmpWorkspaceCwdSchema } from "./hub";
+import { OmpStoreSchema } from "./omp-store";
 
 // Health/compatibility facts about the omp CLI itself, surfaced on the global OMP page. This is
 // an explicit allowlist, not a passthrough: filesystem locations are sanitized display labels
@@ -48,9 +50,12 @@ export const OmpProcessDiagnosticsSchema = z.object({
   /** "partial" means a project daemon directory or candidate metadata file could not be
    * inspected; the count reflects only entries whose metadata was confirmed. */
   status: z.enum(["ok", "partial", "unavailable", "unknown"]),
-  /** Count of daemon-supervised process entries tracked under the hub run root; null
-   * unless "ok" or "partial". */
+  /** Metadata file count under the hub run root, never a count of verified live processes. */
   trackedCount: z.number().int().nonnegative().nullable(),
+  /** Counts by recorded state only; optional for compatibility with older plugin hosts. */
+  activeCount: z.number().int().nonnegative().nullable().optional(),
+  historicalCount: z.number().int().nonnegative().nullable().optional(),
+  unknownCount: z.number().int().nonnegative().nullable().optional(),
 });
 export type OmpProcessDiagnostics = z.infer<typeof OmpProcessDiagnosticsSchema>;
 
@@ -112,6 +117,10 @@ export type OmpProviderHealth = z.infer<typeof OmpProviderHealthSchema>;
 
 export const getOmpProviderHealth = defineRpc({
   name: "paseo-omp.get-provider-health",
-  input: z.object({ force: z.boolean().optional() }),
+  input: z.object({
+    store: OmpStoreSchema.optional(),
+    force: z.boolean().optional(),
+    cwd: OmpWorkspaceCwdSchema.optional(),
+  }),
   output: OmpProviderHealthSchema,
 });

package/shared/quota.ts

@@ -1,5 +1,6 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
+import { OmpStoreSchema } from "./omp-store";
 
 // omp's usage_history stores recorded_at/resets_at as epoch milliseconds (confirmed against
 // live rows: 13-digit values), not seconds. Any "time remaining" math must diff against
@@ -17,6 +18,6 @@ export type OmpQuota = z.infer<typeof OmpQuotaSchema>;
 
 export const listOmpQuotas = defineRpc({
   name: "paseo-omp.list-quotas",
-  input: z.object({}),
+  input: z.object({ store: OmpStoreSchema.optional() }),
   output: z.object({ quotas: z.array(OmpQuotaSchema) }),
 });

package/shared/sessions.ts

@@ -1,5 +1,6 @@
 import { defineRpc } from "@getpaseo/plugin";
 import { z } from "zod";
+import { OmpStoreSchema } from "./omp-store";
 
 const CwdSchema = z.string().min(1).max(4_096);
 
@@ -18,6 +19,6 @@ export type OmpSessionEntry = z.infer<typeof OmpSessionEntrySchema>;
 
 export const listOmpSessions = defineRpc({
   name: "paseo-omp.list-sessions",
-  input: z.object({ cwd: CwdSchema }),
+  input: z.object({ store: OmpStoreSchema.optional(), cwd: CwdSchema }),
   output: z.object({ sessions: z.array(OmpSessionEntrySchema) }),
 });