@mind-harness/mh-workspace 0.0.0-stage → 0.1.0

package/lib/typert.host.d.ts

@@ -0,0 +1,3 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+
+export declare const TYPERT: unknown

package/lib/typert.host.js

@@ -0,0 +1,191 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+import { z } from 'zod'
+
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
+let _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema = () => (_mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema$value ??= z.string())
+let _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema = () => (_mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema$value ??= z.object({
+  'workspaceId': z.string(),
+}))
+let _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema = () => (_mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema$value ??= z.union([z.undefined(), z.string()]))
+let _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema = () => (_mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema$value ??= z.void())
+let _mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema = () => (_mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema$value ??= z.object({
+  'projects': z.array(z.object({
+  'url': z.string(),
+  'name': z.string(),
+  'projectId': z.string(),
+  'workspaceId': z.union([z.undefined(), z.string()]).optional(),
+  'removed': z.union([z.undefined(), z.literal(true)]).optional().describe('The person removed this Project\'s Workspace. It is not in the sidebar.'),
+})),
+  'signedIn': z.boolean().describe('The Memory home names a viewer. Signed out, the list holds only what is public.'),
+  'selfLogin': z.boolean(),
+}))
+let _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema = () => (_mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema$value ??= z.string())
+let _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema = () => (_mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+
+const $remote = createTypertRemoteInfo({
+  package: '@mind-harness/mh-workspace',
+  methods: {
+    'mhWorkspace/ensureWorkspace': {
+      service: 'mhWorkspace',
+      description: 'Put a listed Project back in the sidebar after the person removed it.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'projectUrl',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/ensureWorkspace:projectUrl',
+            create: _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/ensureWorkspace:projectUrl',
+            create: _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/ensureWorkspace:result',
+        create: _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema,
+        jsonSchema: {"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/mh-workspace/src/service.ts","line":175,"column":9},
+    },
+    'mhWorkspace/openPersonWindow': {
+      service: 'mhWorkspace',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'url',
+          source: 'json',
+          acceptsUndefined: true,
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/openPersonWindow:url',
+            create: _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/openPersonWindow:url',
+            create: _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/openPersonWindow:result',
+        create: _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema,
+        jsonSchemaError: 'typert tool schema: unsupported void value',
+      },
+      sourceLocation: {"file":"packages/mh-workspace/src/service.ts","line":184,"column":9},
+    },
+    'mhWorkspace/syncProjects': {
+      service: 'mhWorkspace',
+      description: 'List every reachable Project and register a Workspace for each one that the person has not removed. New Workspaces are registered from the end of the list, so the first Project ends up first: the registry prepends.',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@mind-harness/mh-workspace/views#ProjectsView',
+        create: _mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema,
+        jsonSchema: {"type":"object","properties":{"projects":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"name":{"type":"string"},"projectId":{"type":"string"},"workspaceId":{"type":"string"},"removed":{"type":"boolean","const":true,"description":"The person removed this Project's Workspace. It is not in the sidebar."}},"required":["url","name","projectId"],"additionalProperties":true}},"signedIn":{"type":"boolean","description":"The Memory home names a viewer. Signed out, the list holds only what is public."},"selfLogin":{"type":"boolean"}},"required":["projects","signedIn","selfLogin"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/mh-workspace/src/service.ts","line":161,"column":9},
+    },
+  },
+}, z)
+
+export const TYPERT = {
+  package: '@mind-harness/mh-workspace',
+  face: 'host',
+  schemas: [
+  ],
+  get invocations() { return $remote.descriptors },
+  model: {
+    "services": [
+      {
+        "description": "Host half. Lists Memory projects through the browser request channel, registers one Workspace directory per project, and places the cwd pages on the first step.",
+        "summary": "Host half.",
+        "tags": [],
+        "jsDoc": "/**\n * Host half. Lists Memory projects through the browser request channel,\n * registers one Workspace directory per project, and places the cwd pages\n * on the first step.\n */",
+        "key": "mhWorkspace",
+        "exportName": "MhWorkspaceService",
+        "members": [
+          {
+            "kind": "method",
+            "name": "syncProjects",
+            "signature": "@Remote async syncProjects(signal: AbortSignal): Promise<ProjectsView>",
+            "summary": "List every reachable Project and register a Workspace for each one that the person has not removed.",
+            "jsDoc": "/**\n * List every reachable Project and register a Workspace for each one that\n * the person has not removed. New Workspaces are registered from the end of\n * the list, so the first Project ends up first: the registry prepends.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "ensureWorkspace",
+            "signature": "@Remote async ensureWorkspace(projectUrl: string, signal: AbortSignal): Promise<{ workspaceId: string }>",
+            "summary": "Put a listed Project back in the sidebar after the person removed it.",
+            "jsDoc": "/** Put a listed Project back in the sidebar after the person removed it. */"
+          },
+          {
+            "kind": "method",
+            "name": "openPersonWindow",
+            "signature": "@Remote async openPersonWindow(url?: string, signal?: AbortSignal): Promise<void>"
+          },
+          {
+            "kind": "method",
+            "name": "prepareStep",
+            "signature": "async prepareStep(payload: StepPayload): Promise<void>",
+            "summary": "Keep the Session's Project context current and, on the first step of its first turn, place the cwd pages.",
+            "jsDoc": "/**\n * Keep the Session's Project context current and, on the first step of its\n * first turn, place the cwd pages. Later steps read Memory only while a\n * sign-in gap is open, to notice when it closes.\n */"
+          }
+        ],
+        "types": [
+          {
+            "name": "ProjectsView",
+            "declaration": "export interface ProjectsView {\n    projects: ProjectView[];\n    signedIn: boolean;\n    selfLogin: boolean;\n}"
+          },
+          {
+            "name": "ProjectView",
+            "declaration": "export interface ProjectView {\n    url: string;\n    name: string;\n    projectId: string;\n    workspaceId?: string;\n    removed?: true;\n}"
+          },
+          {
+            "name": "StepPayload",
+            "declaration": "export interface StepPayload {\n    agent: { session: StepSession; };\n    messages: readonly unknown[];\n    step: number;\n    signal: AbortSignal;\n}"
+          },
+          {
+            "name": "StepSession",
+            "declaration": "export interface StepSession {\n    id: string;\n    header: { cwd?: string; };\n}"
+          }
+        ]
+      }
+    ],
+    "events": [
+      {
+        "description": "Volatile config was committed on this plugin fiber. Paths are key arrays.",
+        "summary": "Volatile config was committed on this plugin fiber.",
+        "tags": [],
+        "jsDoc": "/** Volatile config was committed on this plugin fiber. Paths are key arrays. */",
+        "name": "loader/volatile-update",
+        "signature": "'loader/volatile-update'(paths: readonly (readonly string[])[]): void"
+      }
+    ],
+    "objects": []
+  },
+}

package/lib/typert.remote-client.d.ts

@@ -0,0 +1,31 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import type {
+  RemoteResult,
+  TypertRemoteInfo,
+  TypertRemoteMethod,
+} from '@deepseek-ai/dsh-typert-protocol'
+import type { ProjectsView } from '@mind-harness/mh-workspace/views'
+
+declare module '@deepseek-ai/dsh-typert-protocol' {
+  interface TypertRemoteNamespace$6d68576f726b7370616365 {
+    ensureWorkspace: (projectUrl: string, signal?: AbortSignal) => Promise<RemoteResult<{ workspaceId: string; }>>
+    openPersonWindow: (url?: string, signal?: AbortSignal) => Promise<RemoteResult<void>>
+    syncProjects: (signal?: AbortSignal) => Promise<RemoteResult<ProjectsView>>
+  }
+  interface TypertRemoteMap {
+    'mhWorkspace/ensureWorkspace': (projectUrl: string, signal?: AbortSignal) => Promise<RemoteResult<{ workspaceId: string; }>>
+    'mhWorkspace/openPersonWindow': (url?: string, signal?: AbortSignal) => Promise<RemoteResult<void>>
+    'mhWorkspace/syncProjects': (signal?: AbortSignal) => Promise<RemoteResult<ProjectsView>>
+  }
+  interface TypertRemoteNamespaceMap {
+    'mhWorkspace': TypertRemoteNamespace$6d68576f726b7370616365
+  }
+}
+
+export declare const TYPERT_REMOTE: TypertRemoteInfo<{
+  readonly 'mhWorkspace/ensureWorkspace': TypertRemoteMethod<{ readonly 'projectUrl': string }, { workspaceId: string; }>
+  readonly 'mhWorkspace/openPersonWindow': TypertRemoteMethod<{ readonly 'url'?: string }, void>
+  readonly 'mhWorkspace/syncProjects': TypertRemoteMethod<{  }, ProjectsView>
+}>
+export default TYPERT_REMOTE
+//# sourceMappingURL=typert.remote-client.d.ts.map

package/lib/typert.remote-client.js

@@ -0,0 +1,116 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import { z } from 'zod'
+
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
+let _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema = () => (_mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema$value ??= z.string())
+let _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema = () => (_mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema$value ??= z.object({
+  'workspaceId': z.string(),
+}))
+let _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema = () => (_mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema$value ??= z.union([z.undefined(), z.string()]))
+let _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema = () => (_mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema$value ??= z.void())
+let _mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema = () => (_mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema$value ??= z.object({
+  'projects': z.array(z.object({
+  'url': z.string(),
+  'name': z.string(),
+  'projectId': z.string(),
+  'workspaceId': z.union([z.undefined(), z.string()]).optional(),
+  'removed': z.union([z.undefined(), z.literal(true)]).optional().describe('The person removed this Project\'s Workspace. It is not in the sidebar.'),
+})),
+  'signedIn': z.boolean().describe('The Memory home names a viewer. Signed out, the list holds only what is public.'),
+  'selfLogin': z.boolean(),
+}))
+let _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema = () => (_mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema$value ??= z.string())
+let _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema$value
+const _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema = () => (_mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+
+export const TYPERT_REMOTE = createTypertRemoteInfo({
+  package: '@mind-harness/mh-workspace',
+  methods: {
+    'mhWorkspace/ensureWorkspace': {
+      service: 'mhWorkspace',
+      description: 'Put a listed Project back in the sidebar after the person removed it.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'projectUrl',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/ensureWorkspace:projectUrl',
+            create: _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/ensureWorkspace:projectUrl',
+            create: _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/ensureWorkspace:result',
+        create: _mind_harness_mh_workspace_mhWorkspace_ensureWorkspace_result$schema,
+        jsonSchema: {"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/mh-workspace/src/service.ts","line":175,"column":9},
+    },
+    'mhWorkspace/openPersonWindow': {
+      service: 'mhWorkspace',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'url',
+          source: 'json',
+          acceptsUndefined: true,
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/openPersonWindow:url',
+            create: _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/openPersonWindow:url',
+            create: _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@mind-harness/mh-workspace#mhWorkspace/openPersonWindow:result',
+        create: _mind_harness_mh_workspace_mhWorkspace_openPersonWindow_result$schema,
+        jsonSchemaError: 'typert tool schema: unsupported void value',
+      },
+      sourceLocation: {"file":"packages/mh-workspace/src/service.ts","line":184,"column":9},
+    },
+    'mhWorkspace/syncProjects': {
+      service: 'mhWorkspace',
+      description: 'List every reachable Project and register a Workspace for each one that the person has not removed. New Workspaces are registered from the end of the list, so the first Project ends up first: the registry prepends.',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@mind-harness/mh-workspace/views#ProjectsView',
+        create: _mind_harness_mh_workspace_mhWorkspace_syncProjects_result$schema,
+        jsonSchema: {"type":"object","properties":{"projects":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"name":{"type":"string"},"projectId":{"type":"string"},"workspaceId":{"type":"string"},"removed":{"type":"boolean","const":true,"description":"The person removed this Project's Workspace. It is not in the sidebar."}},"required":["url","name","projectId"],"additionalProperties":true}},"signedIn":{"type":"boolean","description":"The Memory home names a viewer. Signed out, the list holds only what is public."},"selfLogin":{"type":"boolean"}},"required":["projects","signedIn","selfLogin"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/mh-workspace/src/service.ts","line":161,"column":9},
+    },
+  },
+}, z)
+
+export default TYPERT_REMOTE

package/lib/types/cites.d.ts

@@ -0,0 +1,11 @@
+export interface CitedPage {
+    url: string;
+    representation?: {
+        kind: string;
+        text?: string;
+    };
+}
+/** Hrefs of one link relation, copied from Agent Views the browser just returned. */
+export declare function linkedUrls(views: readonly CitedPage[], rel: string): string[];
+export declare function sameUrl(left: string, right: string): boolean;
+//# sourceMappingURL=cites.d.ts.map

package/lib/types/codes.d.ts

@@ -0,0 +1,28 @@
+import { RemoteError } from '@deepseek-ai/dsh-typert-protocol';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface RemoteErrorDetailsMap {
+        /** Memory home answered 401. */
+        'mh-workspace/unauthenticated': {
+            readonly title: string;
+            readonly status: number;
+        };
+        /** The response was not JSON, or the request failed. */
+        'mh-workspace/unreadable': {
+            readonly reason: string;
+            readonly status?: number;
+            readonly finalUrl?: string;
+        };
+        /** The address was not in the last syncProjects result. */
+        'mh-workspace/unlisted': {
+            readonly url: string;
+        };
+    }
+}
+export declare function unauthenticated(title: string, status: number): RemoteError;
+export declare function unreadable(reason: string, extra?: {
+    status?: number;
+    finalUrl?: string;
+}): RemoteError;
+export declare function unlisted(url: string): RemoteError;
+export declare function cancelled(): RemoteError;
+//# sourceMappingURL=codes.d.ts.map

package/lib/types/config.d.ts

@@ -0,0 +1,22 @@
+import z from '@deepseek-ai/schemastery';
+export declare const DEFAULT_HOME = "https://mindharness.com/";
+export declare const workspaceConfig: z<Schemastery.ObjectS<NoInfer<{
+    memory: z<Schemastery.ObjectS<NoInfer<{
+        home: z<string, string, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        home: z<string, string, "volatile-defined">;
+    }>>, "defined">;
+    projectsDir: z<string, string, "plain">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    memory: z<Schemastery.ObjectS<NoInfer<{
+        home: z<string, string, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        home: z<string, string, "volatile-defined">;
+    }>>, "defined">;
+    projectsDir: z<string, string, "plain">;
+}>>, "plain">;
+export type WorkspaceConfig = ReturnType<typeof workspaceConfig>;
+export declare function projectsDirOf(config: {
+    projectsDir?: string;
+}): string;
+//# sourceMappingURL=config.d.ts.map

package/lib/types/cwd-pages.d.ts

@@ -0,0 +1,13 @@
+/** What one root-level page of a Project offers toward the cwd pages. */
+export interface RootLevel {
+    readme?: string;
+    rules?: string;
+    next?: string;
+}
+/** One root-level page of a Project; undefined when it is not a readable Agent View. */
+export declare function rootLevel(text: string, url: string): RootLevel | undefined;
+/** The Project's own cwd pages, broad to specific: root README, then root AGENTS.md. */
+export declare function projectPages(levels: readonly RootLevel[]): string[];
+/** Placing order: what those pages require first, then the pages themselves. */
+export declare function placingOrder(required: readonly string[], own: readonly string[]): string[];
+//# sourceMappingURL=cwd-pages.d.ts.map

package/lib/types/domain.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { type DomainSpec } from '@deepseek-ai/dsh-storage-domain';
+export declare const projectRecord: z.ZodObject<{
+    projectId: z.ZodString;
+    url: z.ZodString;
+    workspaceId: z.ZodString;
+    path: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    removed: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ProjectRecord = z.infer<typeof projectRecord>;
+export declare const mhWorkspaceDomain: DomainSpec;
+export interface ProjectTable {
+    get(key: string): ProjectRecord | undefined;
+    entries(): Iterable<[string, ProjectRecord]>;
+    put(key: string, value: ProjectRecord): Promise<void>;
+}
+//# sourceMappingURL=domain.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,26 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type WorkspaceConfig } from './config.ts';
+import { MhWorkspaceService } from './service.ts';
+export declare const name = "mh-workspace";
+export declare const inject: string[];
+export type Config = WorkspaceConfig;
+export declare const Config: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+    memory: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+        home: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        home: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    }>>, "defined">;
+    projectsDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    memory: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+        home: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        home: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    }>>, "defined">;
+    projectsDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+}>>, "plain">;
+export declare function apply(ctx: Context, config: Config): void;
+export { MhWorkspaceService };
+export type { ProjectView, ProjectsView } from './views.ts';
+export { DEFAULT_HOME } from './config.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/json.d.ts

@@ -0,0 +1,16 @@
+export interface ListedProject {
+    url: string;
+    name: string;
+    projectId: string;
+}
+/** Href values for one rel. Array links use `rel`; an object uses the rel as a key. */
+export declare function linkHrefs(page: unknown, rel: string): string[];
+/** Project rows. The address is `items[].id`. `project_id` comes from `fields`. */
+export declare function projectItems(page: unknown): ListedProject[];
+/** Home viewer is present: the browser is signed in. Memory answers 200 either way. */
+export declare function signedInOf(page: unknown): boolean;
+/** Home viewer is present and `act` is absent or empty. */
+export declare function selfLoginOf(page: unknown): boolean;
+export declare function titleOf(page: unknown): string;
+export declare function parseJson(bytes: Uint8Array): unknown;
+//# sourceMappingURL=json.d.ts.map

package/lib/types/notice.d.ts

@@ -0,0 +1,20 @@
+/** The Project a Session's runtime context names, and what is known about reading it. */
+export interface ProjectContext {
+    url: string;
+    name?: string;
+    /** Why Memory cannot show the Project to the browser now. */
+    gap?: string;
+    /** The Project page could not be read on the first step. */
+    unread?: boolean;
+}
+export declare function projectContextText(context: ProjectContext, home: string): string;
+/** What the working directory of a Project's Workspace is. */
+export declare function workingCopySentence(project: string): string;
+/** The `agent/pre-step` decision, as much of it as this plugin reads. */
+export type StepDecision = {
+    kind: 'reject';
+} | {
+    kind: 'enter';
+    messages: unknown[];
+};
+//# sourceMappingURL=notice.d.ts.map

package/lib/types/required.d.ts

@@ -0,0 +1,11 @@
+export interface CitedPage {
+    url: string;
+    representation?: {
+        kind: string;
+        text?: string;
+    };
+}
+/** What these Agent Views list in `requires`, in order, without repeats. */
+export declare function requiredUrls(views: readonly CitedPage[]): string[];
+export declare function sameUrl(left: string, right: string): boolean;
+//# sourceMappingURL=required.d.ts.map

package/lib/types/service.d.ts

@@ -0,0 +1,106 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { ProjectsView } from './views.ts';
+import { type WorkspaceConfig } from './config.ts';
+export type { ProjectView, ProjectsView } from './views.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        mhWorkspace: MhWorkspaceService;
+    }
+    interface Events {
+        /** Volatile config was committed on this plugin fiber. Paths are key arrays. */
+        'loader/volatile-update'(paths: readonly (readonly string[])[]): void;
+    }
+}
+interface StepSession {
+    id: string;
+    header: {
+        cwd?: string;
+    };
+}
+interface StepPayload {
+    agent: {
+        session: StepSession;
+    };
+    messages: readonly unknown[];
+    step: number;
+    signal: AbortSignal;
+}
+/**
+ * Host half. Lists Memory projects through the browser request channel,
+ * registers one Workspace directory per project, and places the cwd pages
+ * on the first step.
+ */
+export declare class MhWorkspaceService extends TypertRemoteService {
+    static inject: string[];
+    private readonly home;
+    private readonly projectsDir;
+    private readonly ready;
+    private table;
+    private listed;
+    /** One sync at a time. A second call waits on this instead of listing again. */
+    private syncing;
+    private readonly contexts;
+    constructor(ctx: Context, config: WorkspaceConfig);
+    /**
+     * List every reachable Project and register a Workspace for each one that
+     * the person has not removed. New Workspaces are registered from the end of
+     * the list, so the first Project ends up first: the registry prepends.
+     */
+    syncProjects(signal: AbortSignal): Promise<ProjectsView>;
+    /** Put a listed Project back in the sidebar after the person removed it. */
+    ensureWorkspace(projectUrl: string, signal: AbortSignal): Promise<{
+        workspaceId: string;
+    }>;
+    openPersonWindow(url?: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Keep the Session's Project context current and, on the first step of its
+     * first turn, place the cwd pages. Later steps read Memory only while a
+     * sign-in gap is open, to notice when it closes.
+     */
+    prepareStep(payload: StepPayload): Promise<void>;
+    /** The first step of the Session's first turn. Later turns do not place pages. */
+    private isFirstStep;
+    /**
+     * The Project this Session's cwd is a working copy of. Only the first step
+     * may ask Memory, to find a Project by directory name; a resumed or forked
+     * Session is matched from storage alone.
+     */
+    private contextFor;
+    private storedProject;
+    /**
+     * Place the cwd pages, broad to specific: what the Project page, the root
+     * README and AGENTS.md require (the Memory home), the README, then
+     * AGENTS.md. The Project page itself is not placed. False when the Project
+     * page could not be read.
+     */
+    private placePages;
+    /** Follow `next` from the first root level until a level names AGENTS.md or none is left. */
+    private laterLevels;
+    private readLevel;
+    /** Why the browser cannot read the person's Projects now; undefined when it can. */
+    private signInGap;
+    private openQuietly;
+    private turns;
+    private browser;
+    private mount;
+    private projects;
+    private byUrl;
+    private doSync;
+    /**
+     * Bring one listed Project in line with its Workspace. A failure here is
+     * the caller's to skip; the rest of the list still registers.
+     */
+    private reconcile;
+    /** Create or reuse the Workspace directory and remember it. Clears `removed`. */
+    private register;
+    private projectForCwd;
+    private readProjects;
+    private recordForPath;
+    /** The configured home. Not http(s) fails closed, before any request. */
+    private memoryHome;
+    private readJson;
+}
+/** Directory segment for one Memory: its host, with `:` written as `_`. */
+export declare function hostDir(home: string): string;
+//# sourceMappingURL=service.d.ts.map

package/lib/types/views.d.ts

@@ -0,0 +1,15 @@
+export interface ProjectView {
+    url: string;
+    name: string;
+    projectId: string;
+    workspaceId?: string;
+    /** The person removed this Project's Workspace. It is not in the sidebar. */
+    removed?: true;
+}
+export interface ProjectsView {
+    projects: ProjectView[];
+    /** The Memory home names a viewer. Signed out, the list holds only what is public. */
+    signedIn: boolean;
+    selfLogin: boolean;
+}
+//# sourceMappingURL=views.d.ts.map

package/lib/types/views.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=views.js.map