@paperclipai/shared 2026.817.0 → 2026.818.0-beta.1

package/dist/validators/adapter-auth-session.d.ts

@@ -0,0 +1,129 @@
+import { z } from "zod";
+export declare const adapterAuthSessionStatusSchema: z.ZodEnum<["starting", "waiting_for_user", "authenticated", "failed", "timed_out", "cancelled"]>;
+export type AdapterAuthSessionStatus = z.infer<typeof adapterAuthSessionStatusSchema>;
+export declare const adapterAuthSessionFailureSchema: z.ZodObject<{
+    reason: z.ZodString;
+    message: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    message: string | null;
+    reason: string;
+}, {
+    message: string | null;
+    reason: string;
+}>;
+export type AdapterAuthSessionFailure = z.infer<typeof adapterAuthSessionFailureSchema>;
+export declare const adapterAuthSessionResponseSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    environmentId: z.ZodString;
+    status: z.ZodEnum<["starting", "waiting_for_user", "authenticated", "failed", "timed_out", "cancelled"]>;
+    expiresAt: z.ZodNullable<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+    failure: z.ZodNullable<z.ZodObject<{
+        reason: z.ZodString;
+        message: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        message: string | null;
+        reason: string;
+    }, {
+        message: string | null;
+        reason: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    failure: {
+        message: string | null;
+        reason: string;
+    } | null;
+    status: "authenticated" | "cancelled" | "failed" | "starting" | "waiting_for_user" | "timed_out";
+    environmentId: string;
+    expiresAt: string | Date | null;
+    sessionId: string;
+}, {
+    failure: {
+        message: string | null;
+        reason: string;
+    } | null;
+    status: "authenticated" | "cancelled" | "failed" | "starting" | "waiting_for_user" | "timed_out";
+    environmentId: string;
+    expiresAt: string | Date | null;
+    sessionId: string;
+}>;
+export type AdapterAuthSessionResponse = z.infer<typeof adapterAuthSessionResponseSchema>;
+export declare const adapterAuthSessionPromptSchema: z.ZodObject<{
+    url: z.ZodString;
+    code: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    url: string;
+}, {
+    code: string;
+    url: string;
+}>;
+export type AdapterAuthSessionPrompt = z.infer<typeof adapterAuthSessionPromptSchema>;
+export declare const adapterAuthSessionOwnerResponseSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    environmentId: z.ZodString;
+    status: z.ZodEnum<["starting", "waiting_for_user", "authenticated", "failed", "timed_out", "cancelled"]>;
+    expiresAt: z.ZodNullable<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+    failure: z.ZodNullable<z.ZodObject<{
+        reason: z.ZodString;
+        message: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        message: string | null;
+        reason: string;
+    }, {
+        message: string | null;
+        reason: string;
+    }>>;
+} & {
+    prompt: z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        code: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        url: string;
+    }, {
+        code: string;
+        url: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    failure: {
+        message: string | null;
+        reason: string;
+    } | null;
+    prompt: {
+        code: string;
+        url: string;
+    } | null;
+    status: "authenticated" | "cancelled" | "failed" | "starting" | "waiting_for_user" | "timed_out";
+    environmentId: string;
+    expiresAt: string | Date | null;
+    sessionId: string;
+}, {
+    failure: {
+        message: string | null;
+        reason: string;
+    } | null;
+    prompt: {
+        code: string;
+        url: string;
+    } | null;
+    status: "authenticated" | "cancelled" | "failed" | "starting" | "waiting_for_user" | "timed_out";
+    environmentId: string;
+    expiresAt: string | Date | null;
+    sessionId: string;
+}>;
+export type AdapterAuthSessionOwnerResponse = z.infer<typeof adapterAuthSessionOwnerResponseSchema>;
+export declare const startAdapterAuthSessionRequestSchema: z.ZodObject<{
+    environmentId: z.ZodString;
+    adapterType: z.ZodEnum<["process", "http", "claude_local", "codex_local", "cursor_cloud", "gemini_local", "grok_local", "hermes_gateway", "hermes_local", "opencode_local", "pi_local", "cursor", "openclaw_gateway"]>;
+    ttlSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    adapterType: "process" | "http" | "claude_local" | "codex_local" | "cursor_cloud" | "gemini_local" | "grok_local" | "hermes_gateway" | "hermes_local" | "opencode_local" | "pi_local" | "cursor" | "openclaw_gateway";
+    environmentId: string;
+    ttlSeconds?: number | undefined;
+}, {
+    adapterType: "process" | "http" | "claude_local" | "codex_local" | "cursor_cloud" | "gemini_local" | "grok_local" | "hermes_gateway" | "hermes_local" | "opencode_local" | "pi_local" | "cursor" | "openclaw_gateway";
+    environmentId: string;
+    ttlSeconds?: number | undefined;
+}>;
+export type StartAdapterAuthSessionRequest = z.infer<typeof startAdapterAuthSessionRequestSchema>;
+//# sourceMappingURL=adapter-auth-session.d.ts.map

package/dist/validators/adapter-auth-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-auth-session.d.ts","sourceRoot":"","sources":["../../src/validators/adapter-auth-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,8BAA8B,kGAAwC,CAAC;AACpF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,+BAA+B;;;;;;;;;EAGjC,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAIxF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMlC,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,8BAA8B;;;;;;;;;EAGhC,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAGtF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEvC,CAAC;AACZ,MAAM,MAAM,+BAA+B,GACzC,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAExD,eAAO,MAAM,oCAAoC;;;;;;;;;;;;EAItC,CAAC;AACZ,MAAM,MAAM,8BAA8B,GACxC,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC"}

package/dist/validators/adapter-auth-session.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { AGENT_ADAPTER_TYPES } from "../constants.js";
+import { ADAPTER_AUTH_SESSION_STATUSES } from "../types/agent.js";
+const isoDateTime = z.union([z.date(), z.string().datetime()]);
+// The public status schema. It accepts only the six public statuses. It rejects
+// an unknown status and both internal states (`promoting`, `cleanup_pending`).
+export const adapterAuthSessionStatusSchema = z.enum(ADAPTER_AUTH_SESSION_STATUSES);
+export const adapterAuthSessionFailureSchema = z.object({
+    reason: z.string().min(1).max(200),
+    message: z.string().min(1).max(1000).nullable(),
+}).strict();
+// The public response schema. `.strict()` rejects an extra field, so a prompt, a
+// token, an account identifier, or a provider lease identifier never validates.
+export const adapterAuthSessionResponseSchema = z.object({
+    sessionId: z.string().uuid(),
+    environmentId: z.string().uuid(),
+    status: adapterAuthSessionStatusSchema,
+    expiresAt: isoDateTime.nullable(),
+    failure: adapterAuthSessionFailureSchema.nullable(),
+}).strict();
+export const adapterAuthSessionPromptSchema = z.object({
+    url: z.string().min(1),
+    code: z.string().min(1),
+}).strict();
+// The owner read schema. It adds the one-time prompt to the public response.
+export const adapterAuthSessionOwnerResponseSchema = adapterAuthSessionResponseSchema.extend({
+    prompt: adapterAuthSessionPromptSchema.nullable(),
+}).strict();
+export const startAdapterAuthSessionRequestSchema = z.object({
+    environmentId: z.string().uuid(),
+    adapterType: z.enum(AGENT_ADAPTER_TYPES),
+    ttlSeconds: z.number().int().min(60).max(24 * 60 * 60).optional(),
+}).strict();
+//# sourceMappingURL=adapter-auth-session.js.map

package/dist/validators/adapter-auth-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-auth-session.js","sourceRoot":"","sources":["../../src/validators/adapter-auth-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AAE/D,gFAAgF;AAChF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAGpF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,iFAAiF;AACjF,gFAAgF;AAChF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAChC,MAAM,EAAE,8BAA8B;IACtC,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qCAAqC,GAAG,gCAAgC,CAAC,MAAM,CAAC;IAC3F,MAAM,EAAE,8BAA8B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClE,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/validators/adapter-registry.d.ts

@@ -8,8 +8,8 @@ export declare const adapterRegistryEntrySchema: z.ZodObject<{
     probeCommand: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     defaultEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
-    enabled: boolean;
     adapterType: string;
+    enabled: boolean;
     allowFqdns?: string[] | undefined;
     envKeys?: string[] | undefined;
     runtimeImage?: string | undefined;
@@ -33,8 +33,8 @@ export declare const adapterRegistrySchema: z.ZodArray<z.ZodObject<{
     probeCommand: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     defaultEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
-    enabled: boolean;
     adapterType: string;
+    enabled: boolean;
     allowFqdns?: string[] | undefined;
     envKeys?: string[] | undefined;
     runtimeImage?: string | undefined;

package/dist/validators/adapter-skills.d.ts

@@ -41,33 +41,33 @@ export declare const agentSkillEntrySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     key: string;
     managed: boolean;
-    state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
     runtimeName: string | null;
     desired: boolean;
-    origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
-    detail?: string | null | undefined;
+    state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
     versionId?: string | null | undefined;
     currentVersionId?: string | null | undefined;
+    origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
     originLabel?: string | null | undefined;
     locationLabel?: string | null | undefined;
     readOnly?: boolean | undefined;
     sourcePath?: string | null | undefined;
     targetPath?: string | null | undefined;
+    detail?: string | null | undefined;
 }, {
     key: string;
     managed: boolean;
-    state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
     runtimeName: string | null;
     desired: boolean;
-    origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
-    detail?: string | null | undefined;
+    state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
     versionId?: string | null | undefined;
     currentVersionId?: string | null | undefined;
+    origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
     originLabel?: string | null | undefined;
     locationLabel?: string | null | undefined;
     readOnly?: boolean | undefined;
     sourcePath?: string | null | undefined;
     targetPath?: string | null | undefined;
+    detail?: string | null | undefined;
 }>;
 export declare const agentSkillSnapshotSchema: z.ZodObject<{
     adapterType: z.ZodString;
@@ -102,83 +102,83 @@ export declare const agentSkillSnapshotSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         key: string;
         managed: boolean;
-        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         runtimeName: string | null;
         desired: boolean;
-        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
-        detail?: string | null | undefined;
+        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         versionId?: string | null | undefined;
         currentVersionId?: string | null | undefined;
+        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
         originLabel?: string | null | undefined;
         locationLabel?: string | null | undefined;
         readOnly?: boolean | undefined;
         sourcePath?: string | null | undefined;
         targetPath?: string | null | undefined;
+        detail?: string | null | undefined;
     }, {
         key: string;
         managed: boolean;
-        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         runtimeName: string | null;
         desired: boolean;
-        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
-        detail?: string | null | undefined;
+        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         versionId?: string | null | undefined;
         currentVersionId?: string | null | undefined;
+        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
         originLabel?: string | null | undefined;
         locationLabel?: string | null | undefined;
         readOnly?: boolean | undefined;
         sourcePath?: string | null | undefined;
         targetPath?: string | null | undefined;
+        detail?: string | null | undefined;
     }>, "many">;
     warnings: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
+    mode: "ephemeral" | "unsupported" | "persistent";
     entries: {
         key: string;
         managed: boolean;
-        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         runtimeName: string | null;
         desired: boolean;
-        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
-        detail?: string | null | undefined;
+        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         versionId?: string | null | undefined;
         currentVersionId?: string | null | undefined;
+        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
         originLabel?: string | null | undefined;
         locationLabel?: string | null | undefined;
         readOnly?: boolean | undefined;
         sourcePath?: string | null | undefined;
         targetPath?: string | null | undefined;
+        detail?: string | null | undefined;
     }[];
-    mode: "ephemeral" | "unsupported" | "persistent";
     adapterType: string;
-    warnings: string[];
     supported: boolean;
     desiredSkills: string[];
+    warnings: string[];
     desiredSkillEntries?: {
         key: string;
         versionId: string | null;
     }[] | undefined;
 }, {
+    mode: "ephemeral" | "unsupported" | "persistent";
     entries: {
         key: string;
         managed: boolean;
-        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         runtimeName: string | null;
         desired: boolean;
-        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
-        detail?: string | null | undefined;
+        state: "stale" | "missing" | "installed" | "external" | "available" | "configured";
         versionId?: string | null | undefined;
         currentVersionId?: string | null | undefined;
+        origin?: "company_managed" | "user_installed" | "external_unknown" | undefined;
         originLabel?: string | null | undefined;
         locationLabel?: string | null | undefined;
         readOnly?: boolean | undefined;
         sourcePath?: string | null | undefined;
         targetPath?: string | null | undefined;
+        detail?: string | null | undefined;
     }[];
-    mode: "ephemeral" | "unsupported" | "persistent";
     adapterType: string;
-    warnings: string[];
     supported: boolean;
     desiredSkills: string[];
+    warnings: string[];
     desiredSkillEntries?: {
         key: string;
         versionId: string | null;