@qilin-agent/tmux-context 3.1.4 → 3.1.6

package/lib/index.js

@@ -53,7 +53,7 @@ const REMOTE_METHOD_DESCRIPTOR = "@qilin-agent/typert-protocol/remote-methods";
 * a Host composition to read it.
 * @param service - owning Service instance, normally `this`.
 * @param serviceKey - exact Cordis service key.
-* @param options - optional distinct wire namespace.
+* @param options - optional wire namespace.
 * @returns a frozen, inspectable binding with no compiler-injected metadata.
 */
 function bindTypertRemote(service, serviceKey, options = {}) {
@@ -61,7 +61,7 @@ function bindTypertRemote(service, serviceKey, options = {}) {
 	const namespace = options.namespace ?? serviceKey;
 	validateName("namespace", namespace);
 	const ctx = Reflect.get(service, "ctx");
-	if (ctx instanceof Context) provideInvocationAccessor(ctx);
+	if (Context.is(ctx)) provideInvocationAccessor(ctx);
 	return Object.freeze({
 		service,
 		serviceKey,
@@ -76,7 +76,7 @@ var TypertRemoteService = class extends Service {
 	* Register the Service and bind the same key to Typert Gateway.
 	* @param ctx - owning Cordis Context.
 	* @param serviceKey - exact Cordis service key and default wire namespace.
-	* @param options - optional distinct wire namespace.
+	* @param options - optional wire namespace.
 	*/
 	constructor(ctx, serviceKey, options = {}) {
 		super(ctx, serviceKey);
@@ -96,21 +96,42 @@ function provideInvocationAccessor(ctx) {
 function Remote(methodExportOrOptions, context) {
 	if (typeof methodExportOrOptions === "string") {
 		validateName("Remote export name", methodExportOrOptions);
-		return remoteDecorator({ kind: "direct" }, void 0, methodExportOrOptions);
-	}
-	if (typeof methodExportOrOptions === "object") {
-		if (remoteOptionMode(methodExportOrOptions) !== "stream" || Reflect.ownKeys(methodExportOrOptions).length !== 1) throw new TypeError("typert-protocol: Remote options must contain exactly mode: \"stream\"");
-		return remoteDecorator({ kind: "direct" }, "stream");
+		return remoteDecorator({ kind: "direct" }, { exportName: methodExportOrOptions });
 	}
+	if (typeof methodExportOrOptions === "object") return remoteDecorator({ kind: "direct" }, markerOptions(methodExportOrOptions, REMOTE_OPTION_KEYS, "Remote options require name, mode: \"stream\", or resources"));
 	if (context === void 0) throw new TypeError("typert-protocol: Remote decorator context is missing");
 	addMarkerInitializer(context, { kind: "direct" });
 }
-function remoteOptionMode(options) {
-	return Reflect.get(options, "mode");
+const REMOTE_OPTION_KEYS = new Set([
+	"name",
+	"mode",
+	"resources"
+]);
+/** Validate one decorator options object against its accepted keys and select the marker fields. */
+function markerOptions(options, accepted, requirement) {
+	const keys = Reflect.ownKeys(options);
+	if (keys.length === 0 || keys.some((key) => typeof key !== "string" || !accepted.has(key)) || Object.hasOwn(options, "mode") && options.mode !== "stream") throw new TypeError(`typert-protocol: ${requirement}`);
+	const { mode, name, resources } = options;
+	if (name !== void 0) validateName("Remote export name", name);
+	return {
+		...mode === void 0 ? {} : { mode },
+		...name === void 0 ? {} : { exportName: name },
+		...resources === void 0 ? {} : { resources: resourceReaders(resources) }
+	};
 }
-function remoteDecorator(invocation, mode, exportName) {
+/** Freeze declared readers into the marker record; a misdeclared reader fails at decoration. */
+function resourceReaders(resources) {
+	const readers = {};
+	for (const [kind, reader] of Object.entries(resources)) {
+		if (typeof reader !== "function") throw new TypeError(`typert-protocol: Remote resource reader "${kind}" must be a function`);
+		readers[kind] = reader;
+	}
+	if (Object.keys(readers).length === 0) throw new TypeError("typert-protocol: Remote resources require at least one reader");
+	return Object.freeze(readers);
+}
+function remoteDecorator(invocation, options = {}) {
 	return function(_method, context) {
-		addMarkerInitializer(context, invocation, mode, exportName);
+		addMarkerInitializer(context, invocation, options);
 	};
 }
 function readRemoteMethodDescriptor(prototype) {
@@ -124,26 +145,27 @@ function readRemoteMethodDescriptor(prototype) {
 	if (!Array.isArray(methods)) throw new TypeError("typert-protocol: Remote method descriptor methods must be an array");
 	return descriptor;
 }
-function addMarkerInitializer(context, invocation, mode, exportName) {
+function addMarkerInitializer(context, invocation, options = {}) {
 	if (context.private || context.static || typeof context.name !== "string") throw new TypeError("typert-protocol: Remote decorators require a public instance method with a string name");
 	const method = context.name;
 	context.addInitializer(function() {
 		const prototype = Object.getPrototypeOf(this);
 		if (prototype === null) throw new TypeError(`typert-protocol: cannot mark Remote method "${method}" on an object without a prototype`);
-		mark(prototype, method, invocation, mode, exportName);
+		mark(prototype, method, invocation, options);
 	});
 }
-function mark(prototype, method, invocation, mode, exportName) {
+function mark(prototype, method, invocation, { mode, exportName, resources }) {
 	const descriptor = readRemoteMethodDescriptor(prototype);
 	const marker = Object.freeze({
 		method,
 		...exportName === void 0 || exportName === method ? {} : { exportName },
 		...mode === void 0 ? {} : { mode },
-		invocation: Object.freeze(invocation)
+		invocation: Object.freeze(invocation),
+		...resources === void 0 ? {} : { resources }
 	});
 	const current = descriptor?.methods.find((candidate) => candidate.method === method);
 	if (current !== void 0) {
-		if (current.exportName === marker.exportName && current.mode === marker.mode && sameInvocation(current.invocation, invocation)) return;
+		if (current.exportName === marker.exportName && current.mode === marker.mode && current.resources === marker.resources && sameInvocation(current.invocation, invocation)) return;
 		throw new Error(`typert-protocol: Remote method "${method}" has conflicting invocation markers`);
 	}
 	Object.defineProperty(prototype, REMOTE_METHOD_DESCRIPTOR, {
@@ -1599,7 +1621,12 @@ var LlmError = class extends HarnessError {
 					if (this.directory.has(entry.provider) && !own.has(entry.provider) || detached.some((seen) => seen.provider === entry.provider)) throw new LlmError(`configurable provider "${entry.provider}" is already declared`, "DUPLICATE_DIRECTORY");
 					detached.push({
 						...entry,
-						settingsPath: [...entry.settingsPath]
+						settingsPath: [...entry.settingsPath],
+						...entry.baseURLEnv === void 0 ? {} : { baseURLEnv: [...entry.baseURLEnv] },
+						...entry.nativeAuth === void 0 ? {} : { nativeAuth: {
+							...entry.nativeAuth,
+							env: [...entry.nativeAuth.env]
+						} }
 					});
 				}
 				for (const entry of held) this.directory.delete(entry.provider);
@@ -1631,7 +1658,12 @@ var LlmError = class extends HarnessError {
 		listConfigurableProviders() {
 			return [...this.directory.values()].map((entry) => ({
 				...entry,
-				settingsPath: [...entry.settingsPath]
+				settingsPath: [...entry.settingsPath],
+				...entry.baseURLEnv === void 0 ? {} : { baseURLEnv: [...entry.baseURLEnv] },
+				...entry.nativeAuth === void 0 ? {} : { nativeAuth: {
+					...entry.nativeAuth,
+					env: [...entry.nativeAuth.env]
+				} }
 			}));
 		}
 		/**
@@ -1724,6 +1756,16 @@ var LlmError = class extends HarnessError {
 			return this.adapters.get(provider)?.adapter.imageRequestPricing(provider, model);
 		}
 		/**
+		* Resolve the image projection for an exact registered model route.
+		* @param provider - registered provider route.
+		* @param model - exact model id.
+		* @param image - normalized image reference.
+		* @returns dimensions and byte target used by the adapter's request serializer.
+		*/
+		imageRequestTarget(provider, model, image) {
+			return this.registration(provider).adapter.imageRequestTarget(provider, model, image);
+		}
+		/**
 		* Resolve the exact text one durable file occurrence contributes to every
 		* provider request in the current execution environment.
 		* @param ref - durable verbatim file reference from model history.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/tmux-context",
   "description": "Opt-in durable per-step context with this agent's tmux pane and window location",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -31,23 +31,23 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5"
   },
   "peerDependencies": {
-    "@qilin-agent/shell": "3.1.4",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/session": "3.1.4",
-    "@qilin-agent/session-projection": "3.1.4",
-    "@qilin-agent/agent": "3.1.4"
+    "@qilin-agent/shell": "3.1.6",
+    "@qilin-agent/session-projection": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/agent": "3.1.6",
+    "@qilin-agent/session": "3.1.6"
   },
   "devDependencies": {
-    "@qilin-agent/shell": "3.1.4",
-    "@qilin-agent/agent-loop-testkit": "3.1.4",
-    "@qilin-agent/session": "3.1.4",
-    "@qilin-agent/llm": "3.1.4",
-    "@qilin-agent/agent": "3.1.4",
-    "@qilin-agent/system-prompt": "3.1.4",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/session-projection": "3.1.4"
+    "@qilin-agent/agent": "3.1.6",
+    "@qilin-agent/shell": "3.1.6",
+    "@qilin-agent/session": "3.1.6",
+    "@qilin-agent/llm": "3.1.6",
+    "@qilin-agent/system-prompt": "3.1.6",
+    "@qilin-agent/agent-loop-testkit": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/session-projection": "3.1.6"
   }
 }