@wangmo-bit/ds-link 0.0.0-stage → 0.8.18

package/src/host/connection.js

@@ -0,0 +1,113 @@
+/**
+ * Authenticated owner control-plane API.
+ *
+ * The route is registered through `ctx.connection.fetch`, so rc.5 applies its
+ * Host/Origin fence and owner-only principal gate before this handler runs.
+ * No cookie parsing, invocation object, or raw webServer route is used.
+ */
+
+import { fail, errorPayload } from '../core/errors.js'
+import { assertAllowedKeys, assertPlainObject, requiredString } from '../core/validation.js'
+
+export const CONNECTION_PATH = '/api/session-link/api'
+export const CONNECTION_METHODS = Object.freeze(['POST'])
+const MAX_BODY_BYTES = 1024 * 1024
+
+/**
+ * @param {Record<string, any>} service
+ * @returns {(request: Request) => Promise<Response>}
+ */
+export function createConnectionHandler(service) {
+  return async (request) => {
+    if (request.method !== 'POST') return envelope(null, 405, 'method_not_allowed', 'POST only')
+    const contentType = request.headers.get('content-type')?.split(';', 1)[0]?.trim().toLowerCase()
+    if (contentType !== 'application/json') {
+      return envelope(null, 415, 'unsupported_media_type', 'content-type must be application/json')
+    }
+    let text
+    try {
+      text = await request.text()
+    } catch {
+      return envelope(null, 400, 'bad_request', 'request body could not be read')
+    }
+    if (Buffer.byteLength(text, 'utf8') > MAX_BODY_BYTES) {
+      return envelope(null, 413, 'payload_too_large', 'request body is too large')
+    }
+    let body
+    try {
+      body = JSON.parse(text)
+    } catch {
+      return envelope(null, 400, 'bad_request', 'body is not JSON')
+    }
+    try {
+      const value = await dispatchRpc(service, body)
+      return jsonResponse({ ok: true, value })
+    } catch (error) {
+      return jsonResponse({ ok: false, error: errorPayload(error) })
+    }
+  }
+}
+
+/**
+ * @param {Record<string, any>} service
+ * @param {unknown} body
+ * @returns {Promise<unknown>}
+ */
+export async function dispatchRpc(service, body) {
+  const object = assertPlainObject(body, 'request body', 'bad_request')
+  assertAllowedKeys(object, ['action', 'payload'], 'request body', 'bad_request')
+  const action = requiredString(object.action, 'action', { max: 64, code: 'bad_request' })
+  const payload = object.payload === undefined ? {} : assertPlainObject(object.payload, 'payload', 'bad_request')
+  if (action === 'snapshot') return service.engine.snapshot(payload)
+  if (action === 'settings') return service.engine.updateSettings(payload)
+  if (action === 'control') return service.engine.ownerControl(payload)
+  // Owner-only bounded card lookup: the rc.5 Host/Origin fence and owner
+  // principal gate run before this handler; the engine then returns only
+  // minimal fields for messages that participate in the requested session.
+  if (action === 'card_lookup') return service.engine.cardLookup(payload)
+  throw fail('invalid_argument', `unknown action ${action}`)
+}
+
+/**
+ * Register the exact fetch route on the shared authenticated channel.
+ * @param {Record<string, any>} ctx
+ * @param {(request: Request) => Promise<Response>} handler
+ * @returns {Promise<() => Promise<void>>}
+ */
+export async function registerConnectionRoute(ctx, handler) {
+  const fetch = ctx.connection?.fetch
+  if (fetch === undefined || typeof fetch.register !== 'function') {
+    throw fail(
+      'unsupported_host',
+      'target Host does not expose the authenticated exact Fetch API; refusing to mount an insecure control plane',
+    )
+  }
+  return fetch.register({
+    path: CONNECTION_PATH,
+    methods: [...CONNECTION_METHODS],
+    requestBody: 'buffered',
+    fetch: handler,
+  })
+}
+
+/**
+ * @param {unknown} value
+ * @param {number} status
+ * @param {string} code
+ * @param {string} message
+ * @returns {Response}
+ */
+function envelope(value, status, code, message) {
+  return jsonResponse(status >= 400 ? { ok: false, error: { code, message } } : { ok: true, value }, status)
+}
+
+/** @param {unknown} body @param {number} [status] @returns {Response} */
+function jsonResponse(body, status = 200) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: {
+      'content-type': 'application/json; charset=utf-8',
+      'cache-control': 'no-store',
+    },
+  })
+}

package/src/host/entry-0.2.0.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry: do not reuse an older index.js callback during rc.5 HMR. */
+import { createSessionLinkPlugin } from './plugin.js'
+export { inject } from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.3.0.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.4.0.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.10.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.11.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.12.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.13.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.14.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.15.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.16-pre.1.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.16-pre.2.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.16-pre.3.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo-bit/ds-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.16-pre.4.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo-bit/ds-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.16-pre.5.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo-bit/ds-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.18.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo-bit/ds-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.5.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.6.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.7.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.8.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/entry-0.8.9.js

@@ -0,0 +1,13 @@
+/** Exact-version physical entry; service/state identity stays unversioned. */
+import { createSessionLinkPlugin } from './plugin.js'
+export * from './index.js'
+export const name = 'session-link'
+let builder
+export async function apply(ctx, config) {
+  if (builder === undefined) {
+    const sdk = await import('@deepseek-ai/dsh-llm')
+    if (typeof sdk.createUserMessage !== 'function') throw new Error('@wangmo/dsh-session-link: Host createUserMessage is unavailable')
+    builder = sdk.createUserMessage
+  }
+  await createSessionLinkPlugin(ctx, config, { createUserMessage: builder })
+}

package/src/host/index.js

@@ -0,0 +1,74 @@
+/**
+ * Package entry. Only this module imports a Host value: the public
+ * `createUserMessage` builder. Everything else is injected so tests can run
+ * against a mock Host without private package internals.
+ */
+
+import { SessionLinkService, createSessionLinkPlugin, normalizeConfig, resolveStateRoot } from './plugin.js'
+
+let hostBuilder
+
+/**
+ * Load the only Host value import lazily. This keeps every source module
+ * importable in tests without a production Harness install, while a real
+ * profile still must provide the exact peer package at apply time.
+ * @returns {Promise<(input: Record<string, any>) => Record<string, any>>}
+ */
+async function createUserMessageBuilder() {
+  if (hostBuilder !== undefined) return hostBuilder
+  let module
+  try {
+    module = await import('@deepseek-ai/dsh-llm')
+  } catch (error) {
+    throw new Error(
+      '@wangmo-bit/ds-link: @deepseek-ai/dsh-llm must be resolvable from this package (peer 0.2.1-rc.5 || 0.2.2-rc.1)',
+      { cause: error },
+    )
+  }
+  if (typeof module.createUserMessage !== 'function') {
+    throw new Error('@wangmo-bit/ds-link: @deepseek-ai/dsh-llm does not export createUserMessage')
+  }
+  hostBuilder = module.createUserMessage
+  return hostBuilder
+}
+
+export const name = 'session-link'
+
+/**
+ * Public Host services this plugin requires. The loader activates the plugin
+ * only after all of them exist; a Host without the authenticated exact Fetch
+ * API is rejected in open() instead of falling back to an unauthenticated
+ * raw webServer route.
+ */
+export const inject = [
+  'sessions',
+  'agents',
+  'sessionController',
+  'workspaceRegistry',
+  'sessionQuery',
+  'connection',
+  'tools',
+  'systemPrompt',
+]
+
+/**
+ * @param {Record<string, any>} ctx
+ * @param {Record<string, unknown>|undefined} config
+ * @returns {Promise<SessionLinkService>}
+ */
+export async function apply(ctx, config) {
+  const createUserMessage = await createUserMessageBuilder()
+  // Cordis accepts only void or an effect disposer from apply; the service is
+  // registered through ctx.provide and tied to the plugin's lifecycle effect.
+  await createSessionLinkPlugin(ctx, config, { createUserMessage })
+}
+
+export { SessionLinkService, createSessionLinkPlugin, normalizeConfig, resolveStateRoot }
+export { Ledger } from '../core/ledger.js'
+export { rollbackPreflight, validateV1State, v3ToV2Preflight } from '../core/migration.js'
+export { v04DowngradePreflight } from '../core/downgrade.js'
+export { SessionLinkEngine } from '../core/engine.js'
+export { HostAdapter } from './adapter.js'
+export { createToolDefinitions } from './tools.js'
+export { CONNECTION_PATH, createConnectionHandler, dispatchRpc, registerConnectionRoute } from './connection.js'
+export { PROMPT_SECTION_NAME, SESSION_LINK_GUIDANCE } from './prompt.js'