@ahpd/agent-claude 0.1.0

package/dist/mcp.js

@@ -0,0 +1,78 @@
+/** The MCP servers a session runs with, read from the files the CLI reads. */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Every MCP server configured for a directory, by name.
+ *
+ * The CLI finds these itself and this host normally leaves it to. It reads
+ * them here for one reason: a server the *SDK* was given is one
+ * `setMcpServers` can re-declare, and a server that came from a settings file
+ * is not - so a token a client signs in with has nowhere to go unless this
+ * host owns the declaration. The files are the CLI's own: `.mcp.json` beside
+ * the project, and `mcpServers` in `~/.claude.json`.
+ *
+ * A file that is missing, unreadable or not JSON contributes nothing. This is
+ * a best effort by design: the CLI still reads the same files, and a server
+ * this misses is a server that works exactly as it did before.
+ */
+export function serversFor(directories) {
+    const found = {};
+    const files = [
+        join(homedir(), '.claude.json'),
+        ...directories.map((dir) => join(dir, '.mcp.json')),
+    ];
+    for (const file of files) {
+        let held;
+        // Synchronous on purpose: these are two small files read once when a
+        // session is created, and a backend's `create` answers with a session
+        // rather than a promise of one.
+        try {
+            held = JSON.parse(readFileSync(file, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        const bag = typeof held === 'object' && held !== null ? held : {};
+        const servers = typeof bag.mcpServers === 'object' && bag.mcpServers !== null ? bag.mcpServers : {};
+        for (const [name, config] of Object.entries(servers)) {
+            // Later wins: a project's own `.mcp.json` is nearer than the home file,
+            // which is the order the CLI resolves them in.
+            if (typeof config === 'object' && config !== null)
+                found[name] = config;
+        }
+    }
+    return found;
+}
+/** The URL an http or sse server lives at, or nothing for a stdio one. */
+export const urlOf = (config) => {
+    const bag = typeof config === 'object' && config !== null ? config : {};
+    const url = typeof bag.url === 'string' ? bag.url : undefined;
+    if (url === undefined)
+        return undefined;
+    const kind = typeof bag.type === 'string' ? bag.type : 'http';
+    return kind === 'http' || kind === 'sse' ? url : undefined;
+};
+/**
+ * What an MCP server says about signing into it, per RFC 9728.
+ *
+ * `<url>/.well-known/oauth-protected-resource`, which is where an OAuth
+ * protected resource publishes its metadata and where a client looks to find
+ * the authorization server. Answers the discovered document, or a bare one
+ * naming the server itself: the URL *is* the canonical resource identifier,
+ * so an incomplete answer is still a true one - what a client loses is the
+ * one-click sign-in, not the knowledge that it needs to sign in.
+ */
+export async function protectedResource(url, name, ms = 15_000) {
+    const bare = { resource: url, resource_name: name };
+    const found = new URL(url);
+    const at = `${found.origin}/.well-known/oauth-protected-resource${found.pathname.replace(/\/+$/, '')}`;
+    const said = await fetch(at, { signal: AbortSignal.timeout(ms) })
+        .then((answer) => (answer.ok ? answer.json() : undefined))
+        .catch(() => undefined);
+    if (typeof said !== 'object' || said === null)
+        return bare;
+    const metadata = said;
+    return typeof metadata.resource === 'string' ? metadata : bare;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/probe.d.ts

@@ -0,0 +1,3 @@
+import type { Offered } from '@ahpd/server';
+export declare function probe(cwd: string): Promise<Offered>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAO,OAAO,EAAE,MAAM,cAAc,CAAC;AA+CjD,wBAAsB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsDzD"}

package/dist/probe.js

@@ -0,0 +1,102 @@
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { customizationsOf, EFFORT_LABELS, EFFORTS } from './session.js';
+/**
+ * Reads what the agent backend offers, once, without creating a session.
+ *
+ * Clients ask `resolveSessionConfig` before creating anything, so the models
+ * and commands have to be known before any session exists. This starts one
+ * short-lived agent process at startup, asks it over the control protocol,
+ * and closes it. No prompt is sent and no transcript is written.
+ */
+const bag = (value) => (typeof value === 'object' && value !== null ? value : {});
+const list = (value) => (Array.isArray(value) ? value : []);
+const str = (value) => (typeof value === 'string' ? value : undefined);
+/**
+ * How hard *this* model can be told to think, as its own config schema.
+ *
+ * Per model and not per session, which is the whole point: the CLI reports a
+ * different `supportedEffortLevels` for each - some take all five, some take
+ * one, and some take none - so a single session-wide effort control offers
+ * levels the chosen model may not have, and accepts one it will then ignore.
+ * A model that supports none gets no schema and a client draws no control,
+ * which is the honest form of "this one does not think harder on request".
+ *
+ * `thinkingLevel` is the key, because that is the one the reference client's
+ * picker writes into `ModelSelection.config` for both of its providers.
+ */
+const thinkingFor = (efforts) => {
+    if (efforts.length === 0)
+        return {};
+    return {
+        configSchema: {
+            type: 'object',
+            properties: {
+                thinkingLevel: {
+                    type: 'string',
+                    title: 'Thinking Level',
+                    description: 'Controls how much reasoning effort Claude uses.',
+                    enum: [...efforts],
+                    enumLabels: efforts.map((one) => EFFORT_LABELS[one] ?? one),
+                    ...(efforts.includes('high') ? { default: 'high' } : {}),
+                },
+            },
+        },
+    };
+};
+export async function probe(cwd) {
+    // A prompt that never yields. The query needs one to exist; it does not need
+    // one to answer what it can do.
+    async function* silence() {
+        await new Promise(() => { });
+        // eslint-disable-next-line no-unreachable
+        return;
+    }
+    const handle = query({ prompt: silence(), options: { cwd } });
+    try {
+        const [init, mcp, skills] = await Promise.all([
+            handle.initializationResult().then((answer) => bag(answer)),
+            // Best effort beside the one that matters: a harness with no MCP servers
+            // and one that will not say are the same empty list here, and neither is
+            // worth failing the probe over.
+            handle.mcpServerStatus().then((answer) => (Array.isArray(answer) ? answer : [])).catch(() => []),
+            handle.reloadSkills().then((answer) => list(bag(answer).skills)).catch(() => []),
+        ]);
+        const styles = list(init.available_output_styles).filter((s) => typeof s === 'string');
+        return {
+            customizations: customizationsOf(init, mcp, skills),
+            // Only when the harness has them. An empty list would draw a picker
+            // with nothing in it, which is worse than no control.
+            ...(styles.length > 0 ? { outputStyles: styles } : {}),
+            ...(str(init.output_style) ? { outputStyle: str(init.output_style) } : {}),
+            models: list(init.models)
+                // `value`, not `id`.
+                .map((raw) => {
+                const model = bag(raw);
+                return {
+                    id: str(model.value) ?? '',
+                    name: str(model.displayName) ?? str(model.value) ?? '',
+                    ...thinkingFor(list(model.supportedEffortLevels).filter((one) => typeof one === 'string')),
+                };
+            })
+                .filter((model) => model.id !== ''),
+            commands: list(init.commands)
+                .map((raw) => {
+                const command = bag(raw);
+                return {
+                    name: str(command.name) ?? '',
+                    ...(str(command.description) ? { description: str(command.description) } : {}),
+                    ...(str(command.argumentHint) ? { argumentHint: str(command.argumentHint) } : {}),
+                };
+            })
+                .filter((command) => command.name !== ''),
+        };
+    }
+    catch {
+        // A harness that will not answer offers nothing, which is a real answer.
+        return { models: [], commands: [], customizations: [] };
+    }
+    finally {
+        handle.close();
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/probe.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,70 @@
+import type { PermissionMode } from '@anthropic-ai/claude-agent-sdk';
+import type { Bag, Session, SessionOptions } from '@ahpd/server';
+/**
+ * The effort levels this backend has, weakest first.
+ *
+ * One list, because two of them drifted: a model's own `thinkingLevel` form
+ * and the session-wide `effortLevel` key are the same five words reaching the
+ * same setting, and a client that read one set of labels from one control and
+ * another set from the other is being told they are different things.
+ */
+export declare const EFFORTS: readonly ["low", "medium", "high", "xhigh", "max"];
+/** What a person reads instead of an effort level. The reference client's words. */
+export declare const EFFORT_LABELS: Record<typeof EFFORTS[number], string>;
+/**
+ * RFC 9728 metadata for a server that needs signing in.
+ *
+ * `resource` is the one field the protocol requires of it - the canonical
+ * identifier a client's `authenticate` must name - so it is the one this
+ * spells out; the rest is whatever the server published.
+ */
+export type Published = Bag & {
+    resource: string;
+};
+/**
+ * What the session was handed, in the protocol's shape.
+ *
+ * Eight `CustomizationType`s and one flat list. `disableUserInvocation` is
+ * what decides whether a skill or prompt appears after a slash - offering one
+ * the host will refuse is worse than not offering it at all.
+ *
+ * The source is the CLI's *control* protocol, not its message stream:
+ * `initializationResult()` and `mcpServerStatus()` answer without a turn
+ * having happened. That matters because everything here is what a client
+ * needs **before** anybody says anything - the models to pick from, the
+ * commands behind a slash. Waiting for the `init` message would mean a
+ * composer that can only offer them once the conversation has started, which
+ * is exactly too late.
+ */
+export declare function customizationsOf(init: Bag, mcp: unknown[], skills?: unknown[], wanted?: Map<string, Published>): Bag[];
+/**
+ * A permission mode a client asked for in somebody else's vocabulary.
+ *
+ * This backend advertises `permissionMode` and its own four values, which is
+ * what the protocol asks a backend to do - the config schema is deliberately
+ * generic, and VS Code's own hosts advertise different properties for Copilot
+ * and for Claude. So the schema stays this harness's.
+ *
+ * What arrives is another matter. A client draws controls from the schema and
+ * *also* dispatches two conventional keys of its own: `autoApprove` (how much
+ * may run unasked) and `mode` (how the agent works). VS Code sends both at
+ * session creation whatever a host advertises, and this host used to answer
+ * `autoApprove is not a config key this backend takes` and leave the session
+ * where it was.
+ *
+ * So they are accepted and mapped here, on the way in, and nothing about what
+ * is advertised changes. Planning wins over any approval level - a plan that
+ * ran a command would not be a plan - and `autopilot` is the mode axis saying
+ * what `autoApprove` says at its top, which is why VS Code's own migration
+ * moved `autoApprove: 'autopilot'` onto that axis.
+ *
+ * `assisted` is the inexact one: VS Code means "assess the risk first" and
+ * this harness has no risk model, so it gets `acceptEdits`, which is the rung
+ * it does have in that place.
+ *
+ * Undefined for a key or a value neither axis knows, so a caller refuses it
+ * rather than collapsing it into `default`.
+ */
+export declare function permissionFor(key: string, value: string): PermissionMode | undefined;
+export declare function createSession(options: SessionOptions): Session;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,KAAK,EAAE,GAAG,EAA6B,OAAO,EAAE,cAAc,EAAY,MAAM,cAAc,CAAC;AAEtG;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,oDAAqD,CAAC;AAE1E,oFAAoF;AACpF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAEhE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAsEnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,GAAG,EAAE,CA4L1H;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAYpF;AAiGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAgpE9D"}