harness-mix 0.1.0

package/src/native-ui/shared-contracts/dist/harness-models.js

@@ -0,0 +1,317 @@
+import { z } from "zod";
+import { codexhostErrorSchema } from "./errors.js";
+import { harnessPermissionModeCatalogSchema, harnessPermissionModeIdSchema, } from "./harness-permission-modes.js";
+import { harnessIdSchema, hostThreadIdSchema } from "./ids.js";
+import { threadUsageSnapshotSchema } from "./thread-usage.js";
+export const HARNESS_MODEL_REF_MAX_LENGTH = 512;
+export const HARNESS_MODEL_LABEL_MAX_LENGTH = 256;
+export const HARNESS_THINKING_OPTION_ID_MAX_LENGTH = 128;
+export const THREAD_OWNERSHIP_LIST_MAX_LENGTH = 100;
+const nonBlankTextSchema = z.string().refine((value) => value.trim().length > 0, {
+    message: "Value must not be empty or whitespace",
+});
+export const harnessModelRefIdSchema = nonBlankTextSchema
+    .max(HARNESS_MODEL_REF_MAX_LENGTH)
+    .regex(/^[A-Za-z0-9._~-]+$/u, "Model Ref must use transport-safe opaque characters")
+    .brand();
+export const harnessModelRefSchema = z
+    .object({
+    id: harnessModelRefIdSchema,
+})
+    .strict();
+export const harnessThinkingOptionIdSchema = nonBlankTextSchema
+    .max(HARNESS_THINKING_OPTION_ID_MAX_LENGTH)
+    .regex(/^[A-Za-z0-9._~-]+$/u, "Thinking option ID must use transport-safe characters")
+    .brand();
+export const harnessResolvedModelLabelSchema = nonBlankTextSchema.max(HARNESS_MODEL_LABEL_MAX_LENGTH);
+export const harnessThinkingOptionSchema = z
+    .object({
+    id: harnessThinkingOptionIdSchema,
+    label: nonBlankTextSchema.max(HARNESS_MODEL_LABEL_MAX_LENGTH),
+})
+    .strict();
+export const harnessModelSchema = z
+    .object({
+    ref: harnessModelRefSchema,
+    label: nonBlankTextSchema.max(HARNESS_MODEL_LABEL_MAX_LENGTH),
+    resolvedModelLabel: harnessResolvedModelLabelSchema.optional(),
+    supportedThinkingOptionIds: z.array(harnessThinkingOptionIdSchema).optional(),
+})
+    .strict();
+const harnessThinkingOptionsSchema = z
+    .array(harnessThinkingOptionSchema)
+    .superRefine((options, context) => {
+    const ids = new Set();
+    for (const [index, option] of options.entries()) {
+        if (ids.has(option.id)) {
+            context.addIssue({
+                code: "custom",
+                message: "Thinking option IDs must be unique",
+                path: [index, "id"],
+            });
+        }
+        ids.add(option.id);
+    }
+});
+export const harnessModelCatalogSchema = z
+    .object({
+    models: z.array(harnessModelSchema),
+    defaultModel: harnessModelRefSchema.optional(),
+    thinkingOptions: harnessThinkingOptionsSchema,
+    defaultThinkingOptionId: harnessThinkingOptionIdSchema.optional(),
+})
+    .strict()
+    .superRefine((catalog, context) => {
+    const refs = new Set();
+    const thinkingIds = new Set(catalog.thinkingOptions.map(({ id }) => id));
+    for (const [index, model] of catalog.models.entries()) {
+        if (refs.has(model.ref.id)) {
+            context.addIssue({
+                code: "custom",
+                message: "Model Catalog refs must be unique",
+                path: ["models", index, "ref", "id"],
+            });
+        }
+        refs.add(model.ref.id);
+        const supportedThinkingIds = new Set();
+        for (const [optionIndex, optionId] of (model.supportedThinkingOptionIds ?? []).entries()) {
+            if (supportedThinkingIds.has(optionId)) {
+                context.addIssue({
+                    code: "custom",
+                    message: "Supported Thinking option IDs must be unique per Model",
+                    path: ["models", index, "supportedThinkingOptionIds", optionIndex],
+                });
+            }
+            supportedThinkingIds.add(optionId);
+            if (!thinkingIds.has(optionId)) {
+                context.addIssue({
+                    code: "custom",
+                    message: "Supported Thinking option must exist in the catalog",
+                    path: ["models", index, "supportedThinkingOptionIds", optionIndex],
+                });
+            }
+        }
+    }
+    if (catalog.defaultModel && !refs.has(catalog.defaultModel.id)) {
+        context.addIssue({
+            code: "custom",
+            message: "Default Model must exist in the Model Catalog",
+            path: ["defaultModel", "id"],
+        });
+    }
+    if (catalog.defaultThinkingOptionId && !thinkingIds.has(catalog.defaultThinkingOptionId)) {
+        context.addIssue({
+            code: "custom",
+            message: "Default Thinking option must exist in the catalog",
+            path: ["defaultThinkingOptionId"],
+        });
+    }
+});
+const harnessHistoryCapabilitiesSchema = z
+    .object({
+    fork: z.boolean(),
+    forkAcrossCwd: z.boolean(),
+    rollbackLastTurn: z.boolean(),
+})
+    .strict()
+    .refine((history) => history.fork || !history.forkAcrossCwd, {
+    path: ["forkAcrossCwd"],
+    message: "Cross-cwd Fork requires exact history Fork support",
+});
+export const harnessPermissionModeScopeSchema = z.enum(["live", "atCreate"]);
+export function permissionModeFixedAtCreate(configuration) {
+    return configuration.permissionModeScope === "atCreate";
+}
+export const harnessSessionCapabilitiesSchema = z
+    .object({
+    configuration: z
+        .object({
+        selectModel: z.boolean(),
+        selectThinkingOption: z.boolean(),
+        selectPermissionMode: z.boolean(),
+        permissionModeScope: harnessPermissionModeScopeSchema.default("live"),
+    })
+        .strict(),
+    history: harnessHistoryCapabilitiesSchema,
+    subagents: z
+        .object({
+        observe: z.boolean(),
+        readTranscript: z.boolean(),
+    })
+        .strict()
+        .optional(),
+    autonomousTurns: z
+        .object({
+        observe: z.boolean(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+export const harnessConfigurationStateSchema = z
+    .object({
+    effectiveModel: harnessModelRefSchema.optional(),
+    resolvedModelLabel: harnessResolvedModelLabelSchema.optional(),
+    effectiveThinkingOptionId: harnessThinkingOptionIdSchema.optional(),
+    availableThinkingOptions: harnessThinkingOptionsSchema.optional(),
+    effectivePermissionModeId: harnessPermissionModeIdSchema.optional(),
+})
+    .strict()
+    .superRefine((state, context) => {
+    if (state.effectiveThinkingOptionId &&
+        state.availableThinkingOptions &&
+        !state.availableThinkingOptions.some(({ id }) => id === state.effectiveThinkingOptionId)) {
+        context.addIssue({
+            code: "custom",
+            message: "Effective Thinking option must be currently available",
+            path: ["effectiveThinkingOptionId"],
+        });
+    }
+});
+export const harnessModelSelectionStateSchema = harnessConfigurationStateSchema;
+export const harnessWebUiCapabilitySchema = z
+    .object({
+    open: z.literal(true),
+})
+    .strict();
+const readyHarnessInspectionSchema = z
+    .object({
+    status: z.literal("ready"),
+    catalog: harnessModelCatalogSchema,
+    permissionModes: harnessPermissionModeCatalogSchema.optional(),
+    capabilities: harnessSessionCapabilitiesSchema,
+    webUi: harnessWebUiCapabilitySchema.optional(),
+})
+    .strict()
+    .superRefine((inspection, context) => {
+    const selectable = inspection.capabilities.configuration.selectPermissionMode;
+    if (selectable !== Boolean(inspection.permissionModes)) {
+        context.addIssue({
+            code: "custom",
+            message: "Permission Mode catalog and capability must agree",
+            path: selectable
+                ? ["permissionModes"]
+                : ["capabilities", "configuration", "selectPermissionMode"],
+        });
+    }
+});
+const failedHarnessInspectionSchema = z
+    .object({
+    status: z.enum(["notInstalled", "unavailable", "error"]),
+    error: codexhostErrorSchema,
+})
+    .strict();
+export const harnessInspectionSchema = z.union([
+    readyHarnessInspectionSchema,
+    failedHarnessInspectionSchema,
+]);
+export const harnessInspectParamsSchema = z
+    .object({
+    harnessId: harnessIdSchema,
+    cwd: nonBlankTextSchema.max(16_384).optional(),
+    refresh: z.boolean().optional(),
+})
+    .strict();
+export const harnessWebUiOpenParamsSchema = z
+    .object({
+    harnessId: harnessIdSchema,
+})
+    .strict();
+export const harnessWebUiOpenResultSchema = z.object({}).strict();
+export const threadModelSelectParamsSchema = z
+    .object({
+    threadId: hostThreadIdSchema,
+    model: harnessModelRefSchema,
+})
+    .strict();
+export const threadThinkingSelectParamsSchema = z
+    .object({
+    threadId: hostThreadIdSchema,
+    thinkingOptionId: harnessThinkingOptionIdSchema,
+})
+    .strict();
+export const threadInspectionParamsSchema = z
+    .object({
+    threadId: hostThreadIdSchema,
+})
+    .strict();
+const codexThreadInspectionSchema = z
+    .object({
+    owner: z.literal("codex"),
+    accountId: nonBlankTextSchema.optional(),
+    locked: z.literal(true),
+})
+    .strict();
+const externalThreadInspectionSchema = z
+    .object({
+    owner: z.literal("external"),
+    harnessId: nonBlankTextSchema.max(256),
+    transportModelId: nonBlankTextSchema.max(1_024),
+    effectiveModel: harnessModelRefSchema.optional(),
+    resolvedModelLabel: harnessResolvedModelLabelSchema.optional(),
+    effectiveThinkingOptionId: harnessThinkingOptionIdSchema.optional(),
+    availableThinkingOptions: harnessThinkingOptionsSchema.optional(),
+    effectivePermissionModeId: harnessPermissionModeIdSchema.optional(),
+    history: harnessHistoryCapabilitiesSchema,
+    usage: threadUsageSnapshotSchema.optional(),
+    locked: z.literal(true),
+})
+    .strict();
+export const threadInspectionSchema = z.discriminatedUnion("owner", [
+    codexThreadInspectionSchema,
+    externalThreadInspectionSchema,
+]);
+export const threadOwnershipListParamsSchema = z
+    .object({
+    threadIds: z.array(hostThreadIdSchema).min(1).max(THREAD_OWNERSHIP_LIST_MAX_LENGTH),
+})
+    .strict()
+    .superRefine(({ threadIds }, context) => {
+    const seen = new Set();
+    for (const [index, threadId] of threadIds.entries()) {
+        if (seen.has(threadId)) {
+            context.addIssue({
+                code: "custom",
+                message: "Thread ownership-list IDs must be unique",
+                path: ["threadIds", index],
+            });
+        }
+        seen.add(threadId);
+    }
+});
+const codexThreadOwnershipSchema = z
+    .object({
+    threadId: hostThreadIdSchema,
+    owner: z.literal("codex"),
+})
+    .strict();
+const externalThreadOwnershipSchema = z
+    .object({
+    threadId: hostThreadIdSchema,
+    owner: z.literal("external"),
+    harnessId: z.string().max(256).pipe(harnessIdSchema),
+})
+    .strict();
+export const threadOwnershipSchema = z.discriminatedUnion("owner", [
+    codexThreadOwnershipSchema,
+    externalThreadOwnershipSchema,
+]);
+export const threadOwnershipListResultSchema = z
+    .object({
+    threads: z.array(threadOwnershipSchema).min(1).max(THREAD_OWNERSHIP_LIST_MAX_LENGTH),
+})
+    .strict()
+    .superRefine(({ threads }, context) => {
+    const seen = new Set();
+    for (const [index, thread] of threads.entries()) {
+        if (seen.has(thread.threadId)) {
+            context.addIssue({
+                code: "custom",
+                message: "Thread ownership-list results must be unique",
+                path: ["threads", index, "threadId"],
+            });
+        }
+        seen.add(thread.threadId);
+    }
+});
+//# sourceMappingURL=harness-models.js.map

package/src/native-ui/shared-contracts/dist/harness-models.js.map

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

package/src/native-ui/shared-contracts/dist/harness-permission-modes.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const HARNESS_PERMISSION_MODE_ID_MAX_LENGTH = 128;
+export declare const HARNESS_PERMISSION_MODE_LABEL_MAX_LENGTH = 256;
+export declare const HARNESS_PERMISSION_MODE_DESCRIPTION_MAX_LENGTH = 1024;
+export declare const HARNESS_PERMISSION_MODE_CATALOG_MAX_LENGTH = 32;
+export declare const harnessPermissionModeIdSchema: z.core.$ZodBranded<z.ZodString, "HarnessPermissionModeId", "out">;
+export type HarnessPermissionModeId = z.infer<typeof harnessPermissionModeIdSchema>;
+export declare const harnessPermissionModeSchema: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "HarnessPermissionModeId", "out">;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    dangerous: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type HarnessPermissionMode = z.infer<typeof harnessPermissionModeSchema>;
+export declare const harnessPermissionModeCatalogSchema: z.ZodObject<{
+    modes: z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "HarnessPermissionModeId", "out">;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        dangerous: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    defaultModeId: z.core.$ZodBranded<z.ZodString, "HarnessPermissionModeId", "out">;
+}, z.core.$strict>;
+export type HarnessPermissionModeCatalog = z.infer<typeof harnessPermissionModeCatalogSchema>;
+export declare const threadPermissionModeSelectParamsSchema: z.ZodObject<{
+    threadId: z.core.$ZodBranded<z.ZodString, "HostThreadId", "out">;
+    permissionModeId: z.core.$ZodBranded<z.ZodString, "HarnessPermissionModeId", "out">;
+}, z.core.$strict>;
+export type ThreadPermissionModeSelectParams = z.infer<typeof threadPermissionModeSelectParamsSchema>;
+//# sourceMappingURL=harness-permission-modes.d.ts.map

package/src/native-ui/shared-contracts/dist/harness-permission-modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-permission-modes.d.ts","sourceRoot":"","sources":["../src/harness-permission-modes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qCAAqC,MAAM,CAAC;AACzD,eAAO,MAAM,wCAAwC,MAAM,CAAC;AAC5D,eAAO,MAAM,8CAA8C,OAAQ,CAAC;AACpE,eAAO,MAAM,0CAA0C,KAAK,CAAC;AAM7D,eAAO,MAAM,6BAA6B,mEAGL,CAAC;AAEtC,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,2BAA2B;;;;;kBAO7B,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,kCAAkC;;;;;;;;kBA4B3C,CAAC;AAEL,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,sCAAsC;;;kBAKxC,CAAC;AAEZ,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAC"}

package/src/native-ui/shared-contracts/dist/harness-permission-modes.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { hostThreadIdSchema } from "./ids.js";
+export const HARNESS_PERMISSION_MODE_ID_MAX_LENGTH = 128;
+export const HARNESS_PERMISSION_MODE_LABEL_MAX_LENGTH = 256;
+export const HARNESS_PERMISSION_MODE_DESCRIPTION_MAX_LENGTH = 1_024;
+export const HARNESS_PERMISSION_MODE_CATALOG_MAX_LENGTH = 32;
+const nonBlankTextSchema = z.string().refine((value) => value.trim().length > 0, {
+    message: "Value must not be empty or whitespace",
+});
+export const harnessPermissionModeIdSchema = nonBlankTextSchema
+    .max(HARNESS_PERMISSION_MODE_ID_MAX_LENGTH)
+    .regex(/^[A-Za-z0-9._~-]+$/u, "Permission Mode ID must use transport-safe characters")
+    .brand();
+export const harnessPermissionModeSchema = z
+    .object({
+    id: harnessPermissionModeIdSchema,
+    label: nonBlankTextSchema.max(HARNESS_PERMISSION_MODE_LABEL_MAX_LENGTH),
+    description: nonBlankTextSchema.max(HARNESS_PERMISSION_MODE_DESCRIPTION_MAX_LENGTH).optional(),
+    dangerous: z.boolean().optional(),
+})
+    .strict();
+export const harnessPermissionModeCatalogSchema = z
+    .object({
+    modes: z
+        .array(harnessPermissionModeSchema)
+        .min(1)
+        .max(HARNESS_PERMISSION_MODE_CATALOG_MAX_LENGTH),
+    defaultModeId: harnessPermissionModeIdSchema,
+})
+    .strict()
+    .superRefine((catalog, context) => {
+    const ids = new Set();
+    for (const [index, mode] of catalog.modes.entries()) {
+        if (ids.has(mode.id)) {
+            context.addIssue({
+                code: "custom",
+                message: "Permission Mode IDs must be unique",
+                path: ["modes", index, "id"],
+            });
+        }
+        ids.add(mode.id);
+    }
+    if (!ids.has(catalog.defaultModeId)) {
+        context.addIssue({
+            code: "custom",
+            message: "Default Permission Mode must exist in the catalog",
+            path: ["defaultModeId"],
+        });
+    }
+});
+export const threadPermissionModeSelectParamsSchema = z
+    .object({
+    threadId: hostThreadIdSchema,
+    permissionModeId: harnessPermissionModeIdSchema,
+})
+    .strict();
+//# sourceMappingURL=harness-permission-modes.js.map

package/src/native-ui/shared-contracts/dist/harness-permission-modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-permission-modes.js","sourceRoot":"","sources":["../src/harness-permission-modes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAG,CAAC;AACzD,MAAM,CAAC,MAAM,wCAAwC,GAAG,GAAG,CAAC;AAC5D,MAAM,CAAC,MAAM,8CAA8C,GAAG,KAAK,CAAC;AACpE,MAAM,CAAC,MAAM,0CAA0C,GAAG,EAAE,CAAC;AAE7D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE;IAC/E,OAAO,EAAE,uCAAuC;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB;KAC5D,GAAG,CAAC,qCAAqC,CAAC;KAC1C,KAAK,CAAC,qBAAqB,EAAE,uDAAuD,CAAC;KACrF,KAAK,EAA6B,CAAC;AAItC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,EAAE,EAAE,6BAA6B;IACjC,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,wCAAwC,CAAC;IACvE,WAAW,EAAE,kBAAkB,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC,QAAQ,EAAE;IAC9F,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,2BAA2B,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,0CAA0C,CAAC;IAClD,aAAa,EAAE,6BAA6B;CAC7C,CAAC;KACD,MAAM,EAAE;KACR,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAChC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,CAAC;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,oCAAoC;gBAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,mDAAmD;YAC5D,IAAI,EAAE,CAAC,eAAe,CAAC;SACxB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAIL,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC;KACpD,MAAM,CAAC;IACN,QAAQ,EAAE,kBAAkB;IAC5B,gBAAgB,EAAE,6BAA6B;CAChD,CAAC;KACD,MAAM,EAAE,CAAC"}

package/src/native-ui/shared-contracts/dist/harness-plugins.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export declare const HARNESS_PLUGIN_API_VERSION = 1;
+export declare const HARNESS_PLUGIN_MANIFEST_MAX_BYTES: number;
+export declare const HARNESS_PLUGIN_ICON_MAX_BYTES: number;
+export declare const HARNESS_PLUGIN_LIMIT = 128;
+/** Plugin identities are portable directory/route keys, not arbitrary Native Session IDs. */
+export declare const harnessPluginIdSchema: z.ZodPipe<z.ZodString, z.core.$ZodBranded<z.ZodString, "HarnessId", "out">>;
+/** A manifest is data only. It must be validated before importing any plugin code. */
+export declare const harnessPluginManifestSchema: z.ZodObject<{
+    adapterApiVersion: z.ZodNumber;
+    entry: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    id: z.ZodPipe<z.ZodString, z.core.$ZodBranded<z.ZodString, "HarnessId", "out">>;
+    name: z.ZodString;
+    version: z.ZodString;
+    links: z.ZodOptional<z.ZodObject<{
+        documentation: z.ZodOptional<z.ZodURL>;
+        installation: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>;
+    manifestVersion: z.ZodLiteral<1>;
+}, z.core.$strict>;
+export type HarnessPluginManifest = z.infer<typeof harnessPluginManifestSchema>;
+/** Images are presentation data; consumers must use an img, never inline markup. */
+export declare const harnessPluginIconSchema: z.ZodString;
+export declare const harnessPluginDescriptorSchema: z.ZodObject<{
+    icon: z.ZodOptional<z.ZodString>;
+    id: z.ZodPipe<z.ZodString, z.core.$ZodBranded<z.ZodString, "HarnessId", "out">>;
+    name: z.ZodString;
+    version: z.ZodString;
+    links: z.ZodOptional<z.ZodObject<{
+        documentation: z.ZodOptional<z.ZodURL>;
+        installation: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type HarnessPluginDescriptor = z.infer<typeof harnessPluginDescriptorSchema>;
+export declare const harnessPluginListParamsSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const harnessPluginListResultSchema: z.ZodObject<{
+    plugins: z.ZodArray<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        id: z.ZodPipe<z.ZodString, z.core.$ZodBranded<z.ZodString, "HarnessId", "out">>;
+        name: z.ZodString;
+        version: z.ZodString;
+        links: z.ZodOptional<z.ZodObject<{
+            documentation: z.ZodOptional<z.ZodURL>;
+            installation: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type HarnessPluginListResult = z.infer<typeof harnessPluginListResultSchema>;
+/** Entries are explicit trust grants. Discovery alone never enables a plugin. */
+export declare const harnessPluginConfigurationSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    enabled: z.ZodArray<z.ZodPipe<z.ZodString, z.core.$ZodBranded<z.ZodString, "HarnessId", "out">>>;
+}, z.core.$strict>;
+export type HarnessPluginConfiguration = z.infer<typeof harnessPluginConfigurationSchema>;
+//# sourceMappingURL=harness-plugins.d.ts.map

package/src/native-ui/shared-contracts/dist/harness-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-plugins.d.ts","sourceRoot":"","sources":["../src/harness-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAC3D,eAAO,MAAM,6BAA6B,QAAa,CAAC;AACxD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,6FAA6F;AAC7F,eAAO,MAAM,qBAAqB,6EAMV,CAAC;AAkCzB,sFAAsF;AACtF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;kBAQ7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,aAG6C,CAAC;AAElF,eAAO,MAAM,6BAA6B;;;;;;;;;kBAK/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,6BAA6B,iCAAwB,CAAC;AACnE,eAAO,MAAM,6BAA6B;;;;;;;;;;;kBAI/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,iFAAiF;AACjF,eAAO,MAAM,gCAAgC;;;kBASzC,CAAC;AACL,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/src/native-ui/shared-contracts/dist/harness-plugins.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { harnessIdSchema } from "./ids.js";
+export const HARNESS_PLUGIN_API_VERSION = 1;
+export const HARNESS_PLUGIN_MANIFEST_MAX_BYTES = 32 * 1024;
+export const HARNESS_PLUGIN_ICON_MAX_BYTES = 128 * 1024;
+export const HARNESS_PLUGIN_LIMIT = 128;
+/** Plugin identities are portable directory/route keys, not arbitrary Native Session IDs. */
+export const harnessPluginIdSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/u)
+    .refine((id) => id !== "codex", "The official Codex identity is reserved")
+    .pipe(harnessIdSchema);
+const relativeResourceSchema = z
+    .string()
+    .min(1)
+    .max(512)
+    .refine((value) => !/[\\\u0000:#?]/u.test(value) &&
+    !value.startsWith("/") &&
+    !value.split("/").some((part) => part === ".." || part === ""), "Plugin resources must be relative paths inside the plugin");
+const documentationUrlSchema = z
+    .url()
+    .refine((value) => /^https:\/\/[^/?#@]+(?:[/?#]|$)/iu.test(value), "Plugin documentation links must be credential-free HTTPS URLs");
+const pluginPresentationShape = {
+    id: harnessPluginIdSchema,
+    name: z.string().trim().min(1).max(128),
+    version: z.string().min(1).max(128),
+    links: z
+        .object({
+        documentation: documentationUrlSchema.optional(),
+        installation: documentationUrlSchema.optional(),
+    })
+        .strict()
+        .optional(),
+};
+/** A manifest is data only. It must be validated before importing any plugin code. */
+export const harnessPluginManifestSchema = z
+    .object({
+    manifestVersion: z.literal(1),
+    ...pluginPresentationShape,
+    adapterApiVersion: z.number().int().positive(),
+    entry: relativeResourceSchema,
+    icon: relativeResourceSchema.optional(),
+})
+    .strict();
+/** Images are presentation data; consumers must use an img, never inline markup. */
+export const harnessPluginIconSchema = z
+    .string()
+    .max(Math.ceil(HARNESS_PLUGIN_ICON_MAX_BYTES / 3) * 4 + 64)
+    .regex(/^data:image\/(?:png|jpeg|webp|svg\+xml);base64,[A-Za-z0-9+/]+={0,2}$/u);
+export const harnessPluginDescriptorSchema = z
+    .object({
+    ...pluginPresentationShape,
+    icon: harnessPluginIconSchema.optional(),
+})
+    .strict();
+export const harnessPluginListParamsSchema = z.object({}).strict();
+export const harnessPluginListResultSchema = z
+    .object({
+    plugins: z.array(harnessPluginDescriptorSchema).max(HARNESS_PLUGIN_LIMIT),
+})
+    .strict();
+/** Entries are explicit trust grants. Discovery alone never enables a plugin. */
+export const harnessPluginConfigurationSchema = z
+    .object({
+    version: z.literal(1),
+    enabled: z.array(harnessPluginIdSchema).max(HARNESS_PLUGIN_LIMIT),
+})
+    .strict()
+    .refine((value) => new Set(value.enabled).size === value.enabled.length, {
+    message: "Enabled plugin IDs must be unique",
+    path: ["enabled"],
+});
+//# sourceMappingURL=harness-plugins.js.map

package/src/native-ui/shared-contracts/dist/harness-plugins.js.map

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

package/src/native-ui/shared-contracts/dist/harness-route.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const HARNESS_PLUGIN_ROUTE_PREFIX = "codexhost/plugin-v1@";
+export declare const harnessPluginRouteSchema: z.ZodObject<{
+    harnessId: z.ZodPipe<z.ZodString, z.core.$ZodBranded<z.ZodString, "HarnessId", "out">>;
+    model: z.ZodOptional<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "HarnessModelRefId", "out">;
+    }, z.core.$strict>>;
+    thinkingOptionId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "HarnessThinkingOptionId", "out">>;
+    permissionModeId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "HarnessPermissionModeId", "out">>;
+}, z.core.$strict>;
+export type HarnessPluginRoute = z.infer<typeof harnessPluginRouteSchema>;
+/** All identity fields are transport-safe ASCII; no Node.js Buffer dependency. */
+export declare function encodeHarnessPluginRoute(route: HarnessPluginRoute): string;
+/** null means another protocol, not an invalid or unavailable external Harness. */
+export declare function decodeHarnessPluginRoute(value: unknown): HarnessPluginRoute | null;
+//# sourceMappingURL=harness-route.d.ts.map

package/src/native-ui/shared-contracts/dist/harness-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-route.d.ts","sourceRoot":"","sources":["../src/harness-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAGlE,eAAO,MAAM,wBAAwB;;;;;;;kBAO1B,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAM1E;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAiBlF"}

package/src/native-ui/shared-contracts/dist/harness-route.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { harnessModelRefSchema, harnessThinkingOptionIdSchema } from "./harness-models.js";
+import { harnessPermissionModeIdSchema } from "./harness-permission-modes.js";
+import { harnessPluginIdSchema } from "./harness-plugins.js";
+export const HARNESS_PLUGIN_ROUTE_PREFIX = "codexhost/plugin-v1@";
+const MAX_ROUTE_LENGTH = 4096;
+export const harnessPluginRouteSchema = z
+    .object({
+    harnessId: harnessPluginIdSchema,
+    model: harnessModelRefSchema.optional(),
+    thinkingOptionId: harnessThinkingOptionIdSchema.optional(),
+    permissionModeId: harnessPermissionModeIdSchema.optional(),
+})
+    .strict();
+/** All identity fields are transport-safe ASCII; no Node.js Buffer dependency. */
+export function encodeHarnessPluginRoute(route) {
+    const parsed = harnessPluginRouteSchema.parse(route);
+    const payload = [...JSON.stringify(parsed)]
+        .map((character) => character.charCodeAt(0).toString(16).padStart(2, "0"))
+        .join("");
+    return `${HARNESS_PLUGIN_ROUTE_PREFIX}${payload}`;
+}
+/** null means another protocol, not an invalid or unavailable external Harness. */
+export function decodeHarnessPluginRoute(value) {
+    if (typeof value !== "string" || !value.startsWith(HARNESS_PLUGIN_ROUTE_PREFIX))
+        return null;
+    const payload = value.slice(HARNESS_PLUGIN_ROUTE_PREFIX.length);
+    if (value.length > MAX_ROUTE_LENGTH || !/^(?:[a-f0-9]{2})+$/u.test(payload)) {
+        throw new Error("Invalid Harness plugin route");
+    }
+    try {
+        const json = payload.replace(/[a-f0-9]{2}/gu, (byte) => String.fromCharCode(Number.parseInt(byte, 16)));
+        const decoded = harnessPluginRouteSchema.parse(JSON.parse(json));
+        if (encodeHarnessPluginRoute(decoded) !== value)
+            throw new Error("Noncanonical Harness plugin route");
+        return decoded;
+    }
+    catch {
+        throw new Error("Invalid Harness plugin route");
+    }
+}
+//# sourceMappingURL=harness-route.js.map

package/src/native-ui/shared-contracts/dist/harness-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-route.js","sourceRoot":"","sources":["../src/harness-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAAsB,CAAC;AAClE,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,SAAS,EAAE,qBAAqB;IAChC,KAAK,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACvC,gBAAgB,EAAE,6BAA6B,CAAC,QAAQ,EAAE;IAC1D,gBAAgB,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CAC3D,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,KAAyB;IAChE,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACzE,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,GAAG,2BAA2B,GAAG,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,2BAA2B,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,GAAG,gBAAgB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CACrD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAC/C,CAAC;QACF,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,wBAAwB,CAAC,OAAO,CAAC,KAAK,KAAK;YAC7C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}