@maiaos/protocol 0.1.0-canary.1

package/dist/provider/effect-schema.js

@@ -0,0 +1,36 @@
+import * as Schema from "effect/Schema";
+import { MAX_PROVIDER_CREDENTIALS_PER_POOL, MAX_PROVIDER_POOL_LIST_RESULT_BYTES, MAX_PROVIDER_POOLS, } from "./policy.js";
+import { PROVIDER_SCHEMA_VERSION } from "./version.js";
+const providerIdentifierEffectSchema = Schema.String.check(Schema.isBetweenLength(1, 128), Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]*$/u));
+const modelIdentifierEffectSchema = Schema.String.check(Schema.isBetweenLength(1, 256), Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:/-]*$/u));
+const credentialCountEffectSchema = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0), Schema.isLessThanOrEqualTo(MAX_PROVIDER_CREDENTIALS_PER_POOL));
+export const providerPoolSummaryEffectSchema = Schema.Struct({
+    availableCredentialCount: credentialCountEffectSchema,
+    credentialCount: credentialCountEffectSchema,
+    default: Schema.Boolean,
+    model: modelIdentifierEffectSchema,
+    poolId: providerIdentifierEffectSchema,
+    providerId: providerIdentifierEffectSchema,
+});
+const providerPoolListResultStructEffectSchema = Schema.Struct({
+    method: Schema.Literal("provider.pool.list"),
+    pools: Schema.Array(providerPoolSummaryEffectSchema).check(Schema.isMaxLength(MAX_PROVIDER_POOLS)),
+    releaseQualified: Schema.Literal(false),
+    schemaVersion: Schema.Literal(PROVIDER_SCHEMA_VERSION),
+});
+const encodedJsonBytes = (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength;
+export const providerPoolListResultEffectSchema = providerPoolListResultStructEffectSchema.check(Schema.makeFilter((value) => {
+    const poolIds = value.pools.map((pool) => pool.poolId);
+    return (new Set(poolIds).size === poolIds.length &&
+        value.pools.filter((pool) => pool.default).length <= 1 &&
+        value.pools.every((pool) => pool.availableCredentialCount <= pool.credentialCount) &&
+        encodedJsonBytes(value) <= MAX_PROVIDER_POOL_LIST_RESULT_BYTES);
+}, {
+    expected: "a bounded provider pool list with unique pool IDs, valid counts, and at most one default",
+}));
+export const providerPoolListParametersEffectSchema = Schema.Record(Schema.String, Schema.Never);
+export const providerRequestPayloadEffectSchema = Schema.Struct({
+    method: Schema.Literal("provider.pool.list"),
+    parameters: providerPoolListParametersEffectSchema,
+});
+//# sourceMappingURL=effect-schema.js.map

package/dist/provider/effect-schema.js.map

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

package/dist/provider/index.d.ts

@@ -0,0 +1,4 @@
+export { type ProviderPoolListParameters, providerPoolListParametersSchema, type ProviderPoolListResult, providerPoolListResultSchema, type ProviderPoolSummary, providerPoolSummarySchema, } from "./contract.js";
+export { MAX_PROVIDER_CREDENTIALS_PER_POOL, MAX_PROVIDER_POOL_LIST_RESULT_BYTES, MAX_PROVIDER_POOLS, } from "./policy.js";
+export { PROVIDER_SCHEMA_VERSION } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/provider/index.js

@@ -0,0 +1,4 @@
+export { providerPoolListParametersSchema, providerPoolListResultSchema, providerPoolSummarySchema, } from "./contract.js";
+export { MAX_PROVIDER_CREDENTIALS_PER_POOL, MAX_PROVIDER_POOL_LIST_RESULT_BYTES, MAX_PROVIDER_POOLS, } from "./policy.js";
+export { PROVIDER_SCHEMA_VERSION } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gCAAgC,EAEhC,4BAA4B,EAE5B,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/provider/policy.d.ts

@@ -0,0 +1,4 @@
+export declare const MAX_PROVIDER_POOLS = 16;
+export declare const MAX_PROVIDER_POOL_LIST_RESULT_BYTES: number;
+export declare const MAX_PROVIDER_CREDENTIALS_PER_POOL = 32;
+//# sourceMappingURL=policy.d.ts.map

package/dist/provider/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/provider/policy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,mCAAmC,QAAY,CAAC;AAC7D,eAAO,MAAM,iCAAiC,KAAK,CAAC"}

package/dist/provider/policy.js

@@ -0,0 +1,4 @@
+export const MAX_PROVIDER_POOLS = 16;
+export const MAX_PROVIDER_POOL_LIST_RESULT_BYTES = 16 * 1024;
+export const MAX_PROVIDER_CREDENTIALS_PER_POOL = 32;
+//# sourceMappingURL=policy.js.map

package/dist/provider/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/provider/policy.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,mCAAmC,GAAG,EAAE,GAAG,IAAI,CAAC;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC"}

package/dist/provider/version.d.ts

@@ -0,0 +1,2 @@
+export declare const PROVIDER_SCHEMA_VERSION: "maia.provider/v1";
+//# sourceMappingURL=version.d.ts.map

package/dist/provider/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/provider/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,EAAG,kBAA2B,CAAC"}

package/dist/provider/version.js

@@ -0,0 +1,2 @@
+export const PROVIDER_SCHEMA_VERSION = "maia.provider/v1";
+//# sourceMappingURL=version.js.map

package/dist/provider/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/provider/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAA2B,CAAC"}

package/dist/reference/contract.d.ts

@@ -0,0 +1,28 @@
+import type { InferRuntimeSchema } from "../runtime-schema/index.js";
+export declare const referenceResolveParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly kind: "connection" | "container" | "project" | "session" | "workspace";
+    readonly path?: string | undefined;
+    readonly projectId?: string | undefined;
+    readonly reference?: string | undefined;
+}>;
+export type ReferenceResolveParameters = InferRuntimeSchema<typeof referenceResolveParametersSchema>;
+export declare const referenceResolveResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly id: string;
+    readonly kind: "connection" | "container" | "project" | "session" | "workspace";
+    readonly label?: string | undefined;
+    readonly match: "id" | "name" | "path" | "prefix" | "selection";
+    readonly method: "reference.resolve";
+    readonly outcome: "resolved";
+    readonly projectId?: string | undefined;
+} | {
+    readonly candidates: readonly {
+        readonly id: string;
+        readonly label?: string | undefined;
+    }[];
+    readonly kind: "connection" | "container" | "project" | "session" | "workspace";
+    readonly method: "reference.resolve";
+    readonly outcome: "ambiguous";
+}>;
+export type ReferenceResolveResult = InferRuntimeSchema<typeof referenceResolveResultSchema>;
+export type ReferenceKind = ReferenceResolveParameters["kind"];
+//# sourceMappingURL=contract.d.ts.map

package/dist/reference/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/reference/contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAOrE,eAAO,MAAM,gCAAgC;;;;;EAE5C,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,CACzD,OAAO,gCAAgC,CACxC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;EAExC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CACrD,OAAO,4BAA4B,CACpC,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC"}

package/dist/reference/contract.js

@@ -0,0 +1,5 @@
+import { makeEffectRuntimeSchema } from "../runtime-schema/effect-schema.js";
+import { referenceResolveParametersEffectSchema, referenceResolveResultEffectSchema, } from "./effect-schema.js";
+export const referenceResolveParametersSchema = makeEffectRuntimeSchema(referenceResolveParametersEffectSchema);
+export const referenceResolveResultSchema = makeEffectRuntimeSchema(referenceResolveResultEffectSchema);
+//# sourceMappingURL=contract.js.map

package/dist/reference/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/reference/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,EACL,sCAAsC,EACtC,kCAAkC,GACnC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,gCAAgC,GAAG,uBAAuB,CACrE,sCAAsC,CACvC,CAAC;AAKF,MAAM,CAAC,MAAM,4BAA4B,GAAG,uBAAuB,CACjE,kCAAkC,CACnC,CAAC"}

package/dist/reference/effect-schema.d.ts

@@ -0,0 +1,59 @@
+import * as Schema from "effect/Schema";
+/**
+ * Resolve `reference` (a full ID, a unique ID prefix or a unique name) to one
+ * resource of `kind`, within `projectId` for a Session or Workspace. Without
+ * `reference`, resolve the default Project or Workspace: the registered
+ * checkout or repository containing `path`, else the selected Workspace.
+ */
+export declare const referenceResolveParametersEffectSchema: Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["connection", "container", "project", "session", "workspace"]>;
+    readonly path: Schema.optional<Schema.String>;
+    readonly projectId: Schema.optional<Schema.String>;
+    readonly reference: Schema.optional<Schema.String>;
+}>;
+export declare const referenceResolveResultEffectSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["connection", "container", "project", "session", "workspace"]>;
+    readonly label: Schema.optional<Schema.String>;
+    readonly match: Schema.Literals<readonly ["id", "prefix", "name", "path", "selection"]>;
+    readonly method: Schema.Literal<"reference.resolve">;
+    readonly outcome: Schema.Literal<"resolved">;
+    /** The Project of a resolved Workspace or Session. */
+    readonly projectId: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+    readonly candidates: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly label: Schema.optional<Schema.String>;
+    }>>;
+    readonly kind: Schema.Literals<readonly ["connection", "container", "project", "session", "workspace"]>;
+    readonly method: Schema.Literal<"reference.resolve">;
+    readonly outcome: Schema.Literal<"ambiguous">;
+}>]>;
+export declare const referenceRequestEffectSchema: Schema.Struct<{
+    readonly method: Schema.Literal<"reference.resolve">;
+    readonly parameters: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["connection", "container", "project", "session", "workspace"]>;
+        readonly path: Schema.optional<Schema.String>;
+        readonly projectId: Schema.optional<Schema.String>;
+        readonly reference: Schema.optional<Schema.String>;
+    }>;
+}>;
+export declare const referenceResultEffectSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["connection", "container", "project", "session", "workspace"]>;
+    readonly label: Schema.optional<Schema.String>;
+    readonly match: Schema.Literals<readonly ["id", "prefix", "name", "path", "selection"]>;
+    readonly method: Schema.Literal<"reference.resolve">;
+    readonly outcome: Schema.Literal<"resolved">;
+    /** The Project of a resolved Workspace or Session. */
+    readonly projectId: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+    readonly candidates: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly label: Schema.optional<Schema.String>;
+    }>>;
+    readonly kind: Schema.Literals<readonly ["connection", "container", "project", "session", "workspace"]>;
+    readonly method: Schema.Literal<"reference.resolve">;
+    readonly outcome: Schema.Literal<"ambiguous">;
+}>]>;
+//# sourceMappingURL=effect-schema.d.ts.map

package/dist/reference/effect-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-schema.d.ts","sourceRoot":"","sources":["../../src/reference/effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAuCxC;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC;;;;;EAiBlD,CAAC;AA2CF,eAAO,MAAM,kCAAkC;;;;;;;IAf7C,sDAAsD;;;;;;;;;;IAkBtD,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;EAGvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;IAzBtC,sDAAsD;;;;;;;;;;IAyBqB,CAAC"}

package/dist/reference/effect-schema.js

@@ -0,0 +1,77 @@
+import * as Schema from "effect/Schema";
+import { protocolIdentifierEffectSchema } from "../envelope/effect-schema.js";
+import { hasControlCharacter } from "../envelope/index.js";
+import { MAX_REFERENCE_CANDIDATES, MAX_REFERENCE_LENGTH, MAX_REFERENCE_PATH_BYTES, REFERENCE_DEFAULT_KINDS, REFERENCE_KINDS, } from "./policy.js";
+const utf8 = new TextEncoder();
+const kindEffectSchema = Schema.Literals(REFERENCE_KINDS);
+/** What a person typed: an ID, an ID prefix, a name or a title. */
+const referenceTextEffectSchema = Schema.String.check(Schema.isBetweenLength(1, MAX_REFERENCE_LENGTH), Schema.makeFilter((value) => !hasControlCharacter(value), {
+    expected: "a one-line reference",
+}));
+/** The caller's absolute working directory, for the default Project or Workspace. */
+const absolutePathEffectSchema = Schema.String.check(Schema.makeFilter((value) => value.startsWith("/") &&
+    !hasControlCharacter(value) &&
+    utf8.encode(value).byteLength <= MAX_REFERENCE_PATH_BYTES, { expected: "an absolute path of at most 4096 bytes" }));
+const defaultKinds = new Set(REFERENCE_DEFAULT_KINDS);
+/** The kinds a Project narrows. */
+const scopedKinds = new Set(["session", "workspace"]);
+/**
+ * Resolve `reference` (a full ID, a unique ID prefix or a unique name) to one
+ * resource of `kind`, within `projectId` for a Session or Workspace. Without
+ * `reference`, resolve the default Project or Workspace: the registered
+ * checkout or repository containing `path`, else the selected Workspace.
+ */
+export const referenceResolveParametersEffectSchema = Schema.Struct({
+    kind: kindEffectSchema,
+    path: Schema.optional(absolutePathEffectSchema),
+    projectId: Schema.optional(protocolIdentifierEffectSchema),
+    reference: Schema.optional(referenceTextEffectSchema),
+}).check(Schema.makeFilter((value) => value.reference === undefined
+    ? defaultKinds.has(value.kind) && value.projectId === undefined
+    : value.path === undefined &&
+        (value.projectId === undefined || scopedKinds.has(value.kind)), {
+    expected: "a reference (narrowed to a Project only for a session or workspace), or no reference and an optional path for a project or workspace",
+}));
+const labelEffectSchema = Schema.String.check(Schema.isBetweenLength(1, 256));
+const candidateEffectSchema = Schema.Struct({
+    id: protocolIdentifierEffectSchema,
+    label: Schema.optional(labelEffectSchema),
+});
+/**
+ * How the Node found the resource: the exact ID, a prefix, a name or title,
+ * the folder at `path` or the selected Workspace.
+ */
+const matchEffectSchema = Schema.Literals([
+    "id",
+    "prefix",
+    "name",
+    "path",
+    "selection",
+]);
+const resolvedEffectSchema = Schema.Struct({
+    id: protocolIdentifierEffectSchema,
+    kind: kindEffectSchema,
+    label: Schema.optional(labelEffectSchema),
+    match: matchEffectSchema,
+    method: Schema.Literal("reference.resolve"),
+    outcome: Schema.Literal("resolved"),
+    /** The Project of a resolved Workspace or Session. */
+    projectId: Schema.optional(protocolIdentifierEffectSchema),
+});
+/** More than one resource matched; the Node never guesses. */
+const ambiguousEffectSchema = Schema.Struct({
+    candidates: Schema.Array(candidateEffectSchema).check(Schema.isMinLength(2), Schema.isMaxLength(MAX_REFERENCE_CANDIDATES)),
+    kind: kindEffectSchema,
+    method: Schema.Literal("reference.resolve"),
+    outcome: Schema.Literal("ambiguous"),
+});
+export const referenceResolveResultEffectSchema = Schema.Union([
+    resolvedEffectSchema,
+    ambiguousEffectSchema,
+]);
+export const referenceRequestEffectSchema = Schema.Struct({
+    method: Schema.Literal("reference.resolve"),
+    parameters: referenceResolveParametersEffectSchema,
+});
+export const referenceResultEffectSchema = referenceResolveResultEffectSchema;
+//# sourceMappingURL=effect-schema.js.map

package/dist/reference/effect-schema.js.map

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

package/dist/reference/feature.d.ts

@@ -0,0 +1,34 @@
+import { type MaiaOperationsFeature } from "../feature/descriptor/index.js";
+/** Names, ID prefixes and the current folder resolved to exact IDs by the Node. */
+export declare const REFERENCE_FEATURE_OPERATIONS: readonly [{
+    readonly method: "reference.resolve";
+    readonly nodeHandler: "reference";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: 'Resolve what a person called a Session, Project, Workspace, Connection or Container (a full ID, an ID prefix of at least 4 hex digits, or a unique name or Session title) to its exact ID. "ambiguous" lists the candidates; pass the exact ID to every other tool. Without reference, a project or workspace kind resolves the folder at path, else the selected Workspace.';
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: false;
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "call";
+    };
+}];
+export declare const REFERENCE_FEATURE: MaiaOperationsFeature<"reference", typeof REFERENCE_FEATURE_OPERATIONS>;
+//# sourceMappingURL=feature.d.ts.map

package/dist/reference/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../src/reference/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AAExC,mFAAmF;AACnF,eAAO,MAAM,4BAA4B;qBAE7B,mBAAmB;0BACd,WAAW;;iBAEtB,YAAY,EAAE,MAAM;iBACpB,WAAW,EAAE,MAAM;iBACnB,WAAW,EAAE,MAAM;iBACnB,UAAU;iBACV,OAAO,EAAE,MAAM;iBACf,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,MAAM;;;;iBAIZ,GAAG;iBACH,WAAW;qBACT,WAAW,EACT,8WAA8W;qBAChX,WAAW;qBACX,QAAQ;;iBAEV,OAAO;iBACP,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,MAAM;;EAEY,CAAC;AAE/D,eAAO,MAAM,iBAAiB,EAAE,qBAAqB,CACnD,WAAW,EACX,OAAO,4BAA4B,CAMnC,CAAC"}

package/dist/reference/feature.js

@@ -0,0 +1,38 @@
+import { defineMaiaFeature, } from "../feature/descriptor/index.js";
+/** Names, ID prefixes and the current folder resolved to exact IDs by the Node. */
+export const REFERENCE_FEATURE_OPERATIONS = [
+    {
+        method: "reference.resolve",
+        nodeHandler: "reference",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: 'Resolve what a person called a Session, Project, Workspace, Connection or Container (a full ID, an ID prefix of at least 4 hex digits, or a unique name or Session title) to its exact ID. "ambiguous" lists the candidates; pass the exact ID to every other tool. Without reference, a project or workspace kind resolves the folder at path, else the selected Workspace.',
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: false,
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "call" },
+    },
+];
+export const REFERENCE_FEATURE = defineMaiaFeature({
+    contributions: { routines: [], rules: [], schedules: [], skills: [] },
+    id: "reference",
+    operations: REFERENCE_FEATURE_OPERATIONS,
+    schemaVersion: "maia.feature/reference/v1",
+});
+//# sourceMappingURL=feature.js.map

package/dist/reference/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../src/reference/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAGlB,MAAM,gCAAgC,CAAC;AAExC,mFAAmF;AACnF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C;QACE,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE,WAAW;QACxB,MAAM,EAAE;YACN,YAAY,EAAE,MAAM;YACpB,WAAW,EAAE,MAAM;YACnB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,MAAM;YACf,gBAAgB,EAAE,KAAK;YACvB,aAAa,EAAE,KAAK;YACpB,IAAI,EAAE,MAAM;SACb;QACD,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE;YACX,GAAG,EAAE,IAAI;YACT,WAAW,EAAE;gBACX,WAAW,EACT,8WAA8W;gBAChX,WAAW,EAAE,KAAK;gBAClB,QAAQ,EAAE,IAAI;aACf;YACD,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;SACb;QACD,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE;KACjD;CAC2D,CAAC;AAE/D,MAAM,CAAC,MAAM,iBAAiB,GAG1B,iBAAiB,CAAC;IACpB,aAAa,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACrE,EAAE,EAAE,WAAW;IACf,UAAU,EAAE,4BAA4B;IACxC,aAAa,EAAE,2BAA2B;CAC3C,CAAC,CAAC"}

package/dist/reference/index.d.ts

@@ -0,0 +1,4 @@
+export { type ReferenceKind, type ReferenceResolveParameters, referenceResolveParametersSchema, type ReferenceResolveResult, referenceResolveResultSchema, } from "./contract.js";
+export { REFERENCE_FEATURE } from "./feature.js";
+export { MAX_REFERENCE_CANDIDATES, MIN_REFERENCE_PREFIX_LENGTH, REFERENCE_KINDS, } from "./policy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/reference/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reference/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/reference/index.js

@@ -0,0 +1,4 @@
+export { referenceResolveParametersSchema, referenceResolveResultSchema, } from "./contract.js";
+export { REFERENCE_FEATURE } from "./feature.js";
+export { MAX_REFERENCE_CANDIDATES, MIN_REFERENCE_PREFIX_LENGTH, REFERENCE_KINDS, } from "./policy.js";
+//# sourceMappingURL=index.js.map

package/dist/reference/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reference/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,gCAAgC,EAEhC,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/reference/policy.d.ts

@@ -0,0 +1,11 @@
+/** The resources a reference can name. */
+export declare const REFERENCE_KINDS: readonly ["connection", "container", "project", "session", "workspace"];
+/** The kinds that have a default when a request names no reference. */
+export declare const REFERENCE_DEFAULT_KINDS: readonly ["project", "workspace"];
+/** The fewest hexadecimal digits an ID prefix needs. */
+export declare const MIN_REFERENCE_PREFIX_LENGTH = 4;
+/** The most candidates an ambiguous reference lists. */
+export declare const MAX_REFERENCE_CANDIDATES = 8;
+export declare const MAX_REFERENCE_LENGTH = 256;
+export declare const MAX_REFERENCE_PATH_BYTES = 4096;
+//# sourceMappingURL=policy.d.ts.map

package/dist/reference/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/reference/policy.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,eAAO,MAAM,eAAe,YAC1B,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,CACH,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,YAAI,SAAS,EAAE,WAAW,CAAU,CAAC;AAEzE,wDAAwD;AACxD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,wDAAwD;AACxD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,wBAAwB,OAAO,CAAC"}

package/dist/reference/policy.js

@@ -0,0 +1,17 @@
+/** The resources a reference can name. */
+export const REFERENCE_KINDS = [
+    "connection",
+    "container",
+    "project",
+    "session",
+    "workspace",
+];
+/** The kinds that have a default when a request names no reference. */
+export const REFERENCE_DEFAULT_KINDS = ["project", "workspace"];
+/** The fewest hexadecimal digits an ID prefix needs. */
+export const MIN_REFERENCE_PREFIX_LENGTH = 4;
+/** The most candidates an ambiguous reference lists. */
+export const MAX_REFERENCE_CANDIDATES = 8;
+export const MAX_REFERENCE_LENGTH = 256;
+export const MAX_REFERENCE_PATH_BYTES = 4096;
+//# sourceMappingURL=policy.js.map

package/dist/reference/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/reference/policy.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,WAAW;IACX,SAAS;IACT,SAAS;IACT,WAAW;CACH,CAAC;AAEX,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,WAAW,CAAU,CAAC;AAEzE,wDAAwD;AACxD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,wDAAwD;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC"}

package/dist/remote-node/bridge-effect-schema.d.ts

@@ -0,0 +1,60 @@
+import * as Schema from "effect/Schema";
+/**
+ * The SSH stdio bridge carries the Node API's own request and response
+ * envelopes, one JSON object per line, between a client and
+ * `maia-node bridge` on the Node's host. The bridge adds a ready handshake
+ * and transport failures and never rewrites an envelope.
+ */
+export declare const BRIDGE_PROTOCOL = "maia.node.stdio/v1";
+/** One envelope plus the frame wrapper. */
+export declare const MAX_BRIDGE_FRAME_BYTES: number;
+/** The same admission limit as the loopback HTTP transport behind it. */
+export declare const MAX_BRIDGE_IN_FLIGHT = 8;
+export declare const bridgeRequestFrameEffectSchema: Schema.Struct<{
+    readonly envelope: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly type: Schema.Literal<"request">;
+}>;
+export declare const bridgeReadyFrameEffectSchema: Schema.Struct<{
+    readonly protocol: Schema.Literal<"maia.node.stdio/v1">;
+    readonly status: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly type: Schema.Literal<"ready">;
+    readonly version: Schema.String;
+}>;
+export declare const bridgeUnavailableFrameEffectSchema: Schema.Struct<{
+    readonly message: Schema.String;
+    readonly protocol: Schema.Literal<"maia.node.stdio/v1">;
+    readonly reason: Schema.Literals<readonly ["credential_unavailable", "node_unavailable"]>;
+    readonly type: Schema.Literal<"unavailable">;
+}>;
+export declare const bridgeResponseFrameEffectSchema: Schema.Struct<{
+    readonly envelope: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly type: Schema.Literal<"response">;
+}>;
+export declare const bridgeFailureFrameEffectSchema: Schema.Struct<{
+    readonly code: Schema.String;
+    readonly message: Schema.String;
+    readonly messageId: Schema.String;
+    readonly remoteError: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly type: Schema.Literal<"failure">;
+}>;
+export declare const bridgeServerFrameEffectSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly protocol: Schema.Literal<"maia.node.stdio/v1">;
+    readonly status: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly type: Schema.Literal<"ready">;
+    readonly version: Schema.String;
+}>, Schema.Struct<{
+    readonly message: Schema.String;
+    readonly protocol: Schema.Literal<"maia.node.stdio/v1">;
+    readonly reason: Schema.Literals<readonly ["credential_unavailable", "node_unavailable"]>;
+    readonly type: Schema.Literal<"unavailable">;
+}>, Schema.Struct<{
+    readonly envelope: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly type: Schema.Literal<"response">;
+}>, Schema.Struct<{
+    readonly code: Schema.String;
+    readonly message: Schema.String;
+    readonly messageId: Schema.String;
+    readonly remoteError: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly type: Schema.Literal<"failure">;
+}>]>;
+//# sourceMappingURL=bridge-effect-schema.d.ts.map

package/dist/remote-node/bridge-effect-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-effect-schema.d.ts","sourceRoot":"","sources":["../../src/remote-node/bridge-effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,QAAsC,CAAC;AAE1E,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAoBtC,eAAO,MAAM,8BAA8B;;;EAGzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;EAKvC,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;EAK7C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;EAG1C,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;EAMzC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;IAKxC,CAAC"}

package/dist/remote-node/bridge-effect-schema.js

@@ -0,0 +1,55 @@
+import * as Schema from "effect/Schema";
+import { MAX_NODE_API_BODY_BYTES } from "../local-node/node-api/index.js";
+/**
+ * The SSH stdio bridge carries the Node API's own request and response
+ * envelopes, one JSON object per line, between a client and
+ * `maia-node bridge` on the Node's host. The bridge adds a ready handshake
+ * and transport failures and never rewrites an envelope.
+ */
+export const BRIDGE_PROTOCOL = "maia.node.stdio/v1";
+/** One envelope plus the frame wrapper. */
+export const MAX_BRIDGE_FRAME_BYTES = MAX_NODE_API_BODY_BYTES + 64 * 1024;
+/** The same admission limit as the loopback HTTP transport behind it. */
+export const MAX_BRIDGE_IN_FLIGHT = 8;
+const messageIdSchema = Schema.String.check(Schema.isBetweenLength(1, 256));
+const objectSchema = Schema.Record(Schema.String, Schema.Unknown);
+const envelopeWith = (field) => objectSchema.check(Schema.makeFilter((value) => {
+    const identifier = value[field];
+    return (typeof identifier === "string" &&
+        identifier.length > 0 &&
+        identifier.length <= 256);
+}, { expected: `an envelope with a ${field}` }));
+export const bridgeRequestFrameEffectSchema = Schema.Struct({
+    envelope: envelopeWith("messageId"),
+    type: Schema.Literal("request"),
+});
+export const bridgeReadyFrameEffectSchema = Schema.Struct({
+    protocol: Schema.Literal(BRIDGE_PROTOCOL),
+    status: objectSchema,
+    type: Schema.Literal("ready"),
+    version: Schema.String.check(Schema.isBetweenLength(1, 64)),
+});
+export const bridgeUnavailableFrameEffectSchema = Schema.Struct({
+    message: Schema.String.check(Schema.isMaxLength(1024)),
+    protocol: Schema.Literal(BRIDGE_PROTOCOL),
+    reason: Schema.Literals(["credential_unavailable", "node_unavailable"]),
+    type: Schema.Literal("unavailable"),
+});
+export const bridgeResponseFrameEffectSchema = Schema.Struct({
+    envelope: envelopeWith("correlationId"),
+    type: Schema.Literal("response"),
+});
+export const bridgeFailureFrameEffectSchema = Schema.Struct({
+    code: Schema.String.check(Schema.isPattern(/^[a-z][a-z_]{0,63}$/u)),
+    message: Schema.String.check(Schema.isMaxLength(1024)),
+    messageId: messageIdSchema,
+    remoteError: Schema.optional(objectSchema),
+    type: Schema.Literal("failure"),
+});
+export const bridgeServerFrameEffectSchema = Schema.Union([
+    bridgeReadyFrameEffectSchema,
+    bridgeUnavailableFrameEffectSchema,
+    bridgeResponseFrameEffectSchema,
+    bridgeFailureFrameEffectSchema,
+]);
+//# sourceMappingURL=bridge-effect-schema.js.map

package/dist/remote-node/bridge-effect-schema.js.map

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