@hy-sde-org/dsh-internal-urls 0.1.1-rc.2

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAEhB,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAMhE;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAE9D,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI;IAU9C,+EAA+E;IAC/E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,2DAA2D;IAC3D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIvD,+BAA+B;IAC/B,OAAO,IAAI,MAAM,EAAE;IAInB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMjC,8DAA8D;IACxD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYjF,4DAA4D;IACtD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlF,gGAAgG;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC;IAMxG,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,aAAa;CAItB"}

package/dist/router.js

@@ -0,0 +1,114 @@
+/**
+ * The internal-URL resolver registry: one handler per scheme, reachable by the
+ * read/grep/write tools as `ctx.internalUrls`. Handlers are stateless where
+ * possible; per-session shared state (ConflictHistory) lives in the service.
+ * @module @hy-sde-org/dsh-internal-urls/router
+ */
+import { parseInternalUrl, extractUriScheme, parseConflictReference } from "./parse.js";
+/**
+ * Validates a handler registration: a non-empty alphabetic scheme, and a
+ * conflict with an existing registration is a programming error (each scheme
+ * may have exactly one handler).
+ */
+export function validateHandler(handler) {
+    const scheme = handler.scheme.toLowerCase();
+    if (!/^[a-z][a-z0-9+.-]*$/.test(handler.scheme)) {
+        throw new Error(`Internal URL handler: invalid scheme '${handler.scheme}'`);
+    }
+    return scheme;
+}
+/**
+ * One resolver registry. `register`/`unregister` manage the handler table;
+ * `canHandle` decides whether a model-supplied path routes away from the
+ * filesystem; `resolve`/`write` dispatch to the matching handler.
+ */
+export class InternalUrlRouter {
+    handlers = new Map();
+    /** Register (or replace) the handler for its scheme. Returns a disposer. */
+    register(handler) {
+        const scheme = validateHandler(handler);
+        const prior = this.handlers.get(scheme);
+        this.handlers.set(scheme, handler);
+        return () => {
+            if (this.handlers.get(scheme) === handler)
+                this.handlers.delete(scheme);
+            else if (prior !== undefined)
+                this.handlers.set(scheme, prior);
+        };
+    }
+    /** Remove the handler for `scheme`; returns false when none was registered. */
+    unregister(scheme) {
+        return this.handlers.delete(scheme.toLowerCase());
+    }
+    /** The registered handler for a scheme, or `undefined`. */
+    getHandler(scheme) {
+        return this.handlers.get(scheme.toLowerCase());
+    }
+    /** Every registered scheme. */
+    schemes() {
+        return [...this.handlers.keys()];
+    }
+    /**
+     * Whether `input` is a hierarchical `scheme://` URL (or the `<path>:conflict://`
+     * selector form) with a registered handler. This is the single gate the
+     * read/grep/write tools consult before touching the filesystem.
+     */
+    canHandle(input) {
+        const scheme = extractUriScheme(input);
+        if (scheme !== undefined)
+            return this.handlers.has(scheme);
+        return parseConflictReference(input) !== null && this.handlers.has('conflict');
+    }
+    /** Resolve an internal URL through its registered handler. */
+    async resolve(input, context) {
+        const parsed = this.route(input);
+        const handler = this.handlers.get(parsed.scheme);
+        if (handler === undefined)
+            throw this.unknownScheme(parsed.scheme);
+        const resource = await handler.resolve(parsed, context);
+        return {
+            ...resource,
+            // The router stamps immutability so handlers never encode the same fact twice.
+            immutable: resource.immutable ?? handler.immutable,
+        };
+    }
+    /** Write an internal URL through its registered handler. */
+    async write(input, content, context) {
+        const parsed = this.route(input);
+        const handler = this.handlers.get(parsed.scheme);
+        if (handler === undefined)
+            throw this.unknownScheme(parsed.scheme);
+        if (handler.write === undefined) {
+            throw new Error(`${parsed.scheme}:// URLs are read-only for write; use the protocol-specific tool for mutations.`);
+        }
+        await handler.write(parsed, content, context);
+    }
+    /** Candidate completions for `scheme://<query>`, or `null` when the scheme has no completer. */
+    async complete(scheme, query, context) {
+        const handler = this.handlers.get(scheme.toLowerCase());
+        if (handler?.complete === undefined)
+            return null;
+        return handler.complete(query, context);
+    }
+    route(input) {
+        let parsed = null;
+        try {
+            parsed = parseInternalUrl(input);
+        }
+        catch {
+            parsed = parseConflictReference(input);
+        }
+        if (parsed === null || !this.handlers.has(parsed.scheme)) {
+            const scheme = extractUriScheme(input) ?? parsed?.scheme;
+            if (scheme === undefined)
+                throw new Error(`Not an internal URL: ${input}`);
+            throw this.unknownScheme(scheme);
+        }
+        return parsed;
+    }
+    unknownScheme(scheme) {
+        const available = this.schemes().map(candidate => `${candidate}://`).join(', ');
+        return new Error(`Unknown protocol: ${scheme}://\nSupported: ${available || 'none'}`);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Vocabulary for the internal-URL routing system: FS-shaped `scheme://` URLs
+ * (`conflict://`, `pr://`, `issue://`, …) resolved by the read/grep/write
+ * tools through one resolver registry (`ctx.internalUrls`).
+ *
+ * A handler resolves a parsed internal URL to an {@link InternalResource}
+ * (text content plus optional backing-file materialization), and may opt into
+ * write dispatch so the write tool can mutate remote/meta surfaces instead of
+ * a literal file.
+ * @module @hy-sde-org/dsh-internal-urls/types
+ */
+/** MIME tags the model-facing text may claim. */
+export type InternalContentType = 'text/markdown' | 'application/json' | 'text/plain';
+/**
+ * Raw resource payload returned by protocol handlers. The `immutable` flag is
+ * applied by the router from {@link ProtocolHandler.immutable}, so handlers do
+ * not need to set it themselves.
+ */
+export interface InternalResource {
+    /** Canonical URL that was resolved. */
+    url: string;
+    /** Resolved text content. */
+    content: string;
+    /** MIME type of `content`. */
+    contentType: InternalContentType;
+    /** Content size in bytes, when known. */
+    size?: number;
+    /**
+     * Underlying filesystem path, when the resource is backed by a local file
+     * (e.g. a future `local://`). The agent-facing display stays `url`; the path
+     * is for materializing edits and searches.
+     */
+    sourcePath?: string;
+    /** Additional notes about resolution, rendered below the content. */
+    notes?: string[];
+    /**
+     * True when the resolved content cannot be edited by the agent (sealed
+     * artifacts, harness docs, machine-generated summaries). Mutable resources
+     * (conflict regions) behave like editable files.
+     */
+    immutable?: boolean;
+    /**
+     * True when the resource is a directory listing rather than file content.
+     * `grep` refuses such a resource without a `sourcePath`.
+     */
+    isDirectory?: boolean;
+}
+/**
+ * A single autocomplete candidate for the host/path portion of a `scheme://`
+ * URL, produced by {@link ProtocolHandler.complete}.
+ */
+export interface UrlCompletion {
+    /** The text that follows `scheme://` for this candidate. */
+    value: string;
+    /** Human-facing label for the dropdown; defaults to {@link value}. */
+    label?: string;
+    /** Optional one-line description shown beside the candidate. */
+    description?: string;
+}
+/**
+ * A parsed internal URL (`scheme://host/path?query`). Keeps the raw segments
+ * before URL normalization so numeric hosts, casing, and traversal markers
+ * survive, and carries the exact input string for byte-exact matching.
+ */
+export interface ParsedInternalUrl {
+    /** Scheme without the `:` (already lowercased), e.g. `conflict`, `pr`. */
+    scheme: string;
+    /** Raw host segment exactly as typed (case preserved, no normalization). */
+    rawHost: string;
+    /** Raw pathname exactly as typed (leading `/` preserved, no normalization). */
+    rawPathname: string;
+    /**
+     * Decoded non-empty path segments following the leading slash. Rejects
+     * empty, `.`, and `..` segments.
+     */
+    pathSegments: string[];
+    /** Query parameters under `?…` (empty when the input carries none). */
+    searchParams: URLSearchParams;
+    /** Normalized href (`new URL(input).href`). */
+    href: string;
+    /** The exact input string, before any normalization. */
+    rawHref: string;
+}
+/**
+ * Caller-supplied context threaded into handlers so schemes that resolve
+ * against the calling session (default repo, conflict history, cwd-relative
+ * files) act on the session that initiated the read/write, never the first
+ * session to register.
+ */
+export interface ResolveContext {
+    /** Working directory of the calling session. */
+    cwd?: string;
+    /** The caller's abort signal. */
+    signal?: AbortSignal;
+    /**
+     * Opaque per-session key used for session-scoped handler state (e.g.
+     * {@link module:@hy-sde-org/dsh-internal-urls/conflict ConflictHistory}).
+     */
+    sessionKey?: string;
+    /**
+     * When set, handlers that would otherwise materialize expensive content may
+     * return the resource shape with `content` empty — callers that only need
+     * `sourcePath` (search) pass this so a large resource still resolves without
+     * buffering it.
+     */
+    pathOnly?: boolean;
+}
+/** Caller context for write dispatch to host-owned URI handlers. */
+export interface WriteContext {
+    /** Working directory of the calling session. */
+    cwd?: string;
+    /** The caller's abort signal. */
+    signal?: AbortSignal;
+    /** Opaque per-session key — see {@link ResolveContext.sessionKey}. */
+    sessionKey?: string;
+    /**
+     * Opaque per-call sandbox policy (the write tool's resolved mode + workspace
+     * root) forwarded so a handler that mutates a backing file keeps the same
+     * confinement semantics as a plain `write` call. Opaque here; the handler's
+     * file bridge applies it when calling `ctx.fs`.
+     */
+    sandboxPolicy?: unknown;
+}
+/**
+ * A handler for a specific internal URL scheme (e.g. `conflict://`, `pr://`).
+ */
+export interface ProtocolHandler {
+    /** The scheme without trailing `://` (e.g. `conflict`). */
+    readonly scheme: string;
+    /**
+     * Whether resources produced by this handler are immutable (never editable
+     * by the agent). `true` suppresses write affordances; `false` marks the
+     * resource as writable (e.g. conflict regions).
+     */
+    readonly immutable: boolean;
+    /** Resolve an internal URL to its content. Throws a user-friendly error on failure. */
+    resolve(url: ParsedInternalUrl, context?: ResolveContext): Promise<InternalResource>;
+    /**
+     * Optional write hook. When present, the write tool dispatches
+     * `write(url, content)` here instead of writing to a filesystem path.
+     * Handlers that omit it are read-only.
+     */
+    write?(url: ParsedInternalUrl, content: string, context?: WriteContext): Promise<void>;
+    /**
+     * Optional autocomplete hook — candidate completions for the host/path
+     * portion of a `scheme://` URL. Must be fast and local; omitted by network
+     * backed schemes.
+     */
+    complete?(query?: string, context?: ResolveContext): Promise<UrlCompletion[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iDAAiD;AACjD,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,kBAAkB,GAAG,YAAY,CAAA;AAErF;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,WAAW,EAAE,mBAAmB,CAAA;IAChC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,uEAAuE;IACvE,YAAY,EAAE,eAAe,CAAA;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,uFAAuF;IACvF,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACpF;;;;OAIG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF;;;;OAIG;IACH,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;CAC9E"}

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * Vocabulary for the internal-URL routing system: FS-shaped `scheme://` URLs
+ * (`conflict://`, `pr://`, `issue://`, …) resolved by the read/grep/write
+ * tools through one resolver registry (`ctx.internalUrls`).
+ *
+ * A handler resolves a parsed internal URL to an {@link InternalResource}
+ * (text content plus optional backing-file materialization), and may opt into
+ * write dispatch so the write tool can mutate remote/meta surfaces instead of
+ * a literal file.
+ * @module @hy-sde-org/dsh-internal-urls/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/examples/agent-preset/agent.cordis.yml

@@ -0,0 +1,26 @@
+# User agent preset for @hy-sde-org/dsh-internal-urls on OFFICIAL DeepSeek
+# Harness releases (dsh-v0.1.1-rc.2 and later).
+#
+# Install: copy this directory to ~/.dsh/.agent-presets/<id>/ (pick any id),
+# then select the preset in the Web UI preset picker (or `dsh agent` CLI).
+# All three packages must be installed (`dsh plugin add`) so these rows
+# resolve; the `internal-urls` SERVICE row is added host-wide by the bundle.
+#
+# These rows mount the ROUTING `read`/`write`/`edit` (dsh-tool-fs-internal-urls)
+# and `grep` (dsh-tool-fs-search-internal-urls) — fork builds of the harness
+# tool packages that resolve conflict://, issue://, pr:// etc. through the
+# host registry and behave exactly like the stock tools on plain filesystem
+# paths. Agent-scope shadowing makes them THE read/write/grep for this
+# session; the deployment's stock read/write/grep keep serving other scopes.
+#
+# Copy any other rows from the preset you normally use (persona, bash, todo,
+# ask-user, skills, ...) next to these; only the two filesystem rows are
+# special. `sampleOverCapGlobResults` is a required tool-fs-search config.
+
+- id: tool-fs-internal-urls
+  name: '@hy-sde-org/dsh-tool-fs-internal-urls'
+
+- id: tool-fs-search-internal-urls
+  name: '@hy-sde-org/dsh-tool-fs-search-internal-urls'
+  config:
+    sampleOverCapGlobResults: false

package/examples/agent-preset/preset.yml

@@ -0,0 +1,3 @@
+name: Internal URLs (fs-shaped)
+description: Coding agent whose read/write/grep resolve conflict://, pr://, and issue:// URLs through the internal-urls registry. For stock DeepSeek Harness releases (rc.2+).
+order: 7

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "@hy-sde-org/dsh-internal-urls",
+  "version": "0.1.1-rc.2",
+  "description": "FS-shaped internal URL schemes (conflict://, pr://, issue://, …) resolved through one registry behind the read/grep/write tools — a standalone service plugin for DeepSeek Harness with no upstream harness changes required.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./parse": {
+      "types": "./dist/parse.d.ts",
+      "default": "./dist/parse.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    "./router": {
+      "types": "./dist/router.d.ts",
+      "default": "./dist/router.js"
+    },
+    "./conflict": {
+      "types": "./dist/conflict.d.ts",
+      "default": "./dist/conflict.js"
+    },
+    "./gh": {
+      "types": "./dist/gh.d.ts",
+      "default": "./dist/gh.js"
+    },
+    "./issue-pr": {
+      "types": "./dist/issue-pr.d.ts",
+      "default": "./dist/issue-pr.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "cordis.patch.yml",
+    "examples/agent-preset/agent.cordis.yml",
+    "examples/agent-preset/preset.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hy-sde/dsh-internal-urls.git"
+  },
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-sandbox": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subprocess": "^0.1.1-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-sandbox": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subprocess": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7",
+    "@hy-sde-org/dsh-tool-fs-internal-urls": "0.1.1-rc.2"
+  },
+  "keywords": [
+    "deepseek",
+    "agent",
+    "harness",
+    "dsh-plugin",
+    "internal-urls",
+    "conflict",
+    "github",
+    "pr",
+    "issue"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}