@deepseek-ai/dsh-experimental-liveshare 0.0.0-stage → 0.2.2-alpha.2

package/lib/typert.remote-client.js

@@ -0,0 +1,551 @@
+/* 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 _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0$schema$value ??= z.object({
+  'shareId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_result$schema$value ??= z.object({
+  'events': z.array(z.object({
+  'id': z.string().readonly(),
+  'action': z.string().readonly(),
+  'createdAt': z.string().readonly(),
+  'actor': z.string().readonly().optional(),
+  'detail': z.json().readonly().optional(),
+})).readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_capabilities_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_capabilities_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_capabilities_result$schema$value ??= z.object({
+  'capabilities': z.array(z.object({
+  'plugin': z.string().readonly().describe('Declaring plugin\'s package name.'),
+  'readable': z.array(z.string()).readonly().describe('Readable endpoints that plugin offers.'),
+  'writable': z.array(z.string()).readonly().describe('Writable endpoints that plugin offers.'),
+})).readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0$schema$value ??= z.object({
+  'sessionId': z.string().readonly(),
+  'sessionTitle': z.string().readonly().optional().describe('Display title; the Session id is used when this is absent or empty.'),
+  'accessMode': z.union([z.literal("open"), z.literal("selected")]).readonly().optional().describe('Access mode to store with the share. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no access mode, while stored `selected` records and callers that invoke this Remote directly still set it.'),
+  'ttlMinutes': z.number().readonly().optional().describe('Lifetime in minutes; absent means the share never expires.'),
+  'allowedSubjectIds': z.array(z.string()).readonly().optional().describe('Viewers named on a `selected` share, stored beside the deployment\'s allowed subjects. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no subjects.'),
+  'allowsFork': z.boolean().readonly().optional(),
+  'sessionMode': z.union([z.literal("write"), z.literal("view")]).readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_result$schema$value ??= z.object({
+  'link': z.string().readonly(),
+  'shareId': z.string().readonly(),
+  'sessionId': z.string().readonly(),
+  'sessionMode': z.union([z.literal("write"), z.literal("view")]).readonly(),
+  'access': z.object({
+  'mode': z.union([z.literal("open"), z.literal("selected")]).readonly(),
+  'selected': z.array(z.object({
+  'providerId': z.string().readonly(),
+  'tenantId': z.string().readonly(),
+  'subjectId': z.string().readonly(),
+  'identityKey': z.string().readonly(),
+})).readonly(),
+  'deploymentAllowedSubjectIds': z.array(z.string()).readonly(),
+  'shareAllowedSubjectIds': z.array(z.string()).readonly(),
+  'broadenedByDeploymentSubjects': z.boolean().readonly(),
+  'identityKeyAcl': z.literal(true).readonly(),
+}).readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0$schema$value ??= z.object({
+  'relay': z.string().readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_result$schema$value ??= z.object({
+  'state': z.union([z.literal("expired"), z.literal("verified"), z.literal("unverified"), z.literal("relay-unsupported")]).readonly(),
+  'relay': z.string().readonly().describe('Relay base URL the credential is bound to. A host keeps one credential per Relay address and never presents it to another, so a viewer of this field compares it with the active address.'),
+  'displayName': z.string().readonly().optional().describe('Provider display name, when the credential carries one.'),
+  'subjectId': z.string().readonly().optional().describe('Verified subject id, which a client may show as the identity label.'),
+  'avatarUrl': z.string().readonly().optional().describe('Provider-issued avatar URL the credential carried, when it carried one.'),
+  'expiresAt': z.string().readonly().optional().describe('ISO expiry of the credential currently held.'),
+  'renewed': z.boolean().readonly().optional().describe('True when this report followed a renewal that pushed the expiry out.'),
+  'claim': z.object({
+  'claimed': z.number().readonly().describe('Shares the Relay bound to this identity.'),
+  'skipped': z.number().readonly().describe('Shares already bound to this identity, so the Relay left them untouched.'),
+}).readonly().optional().describe('Automatic claim result, present once this host has run a claim pass.'),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_list_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_list_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_list_result$schema$value ??= z.object({
+  'shares': z.array(z.object({
+  'shareId': z.string().readonly(),
+  'sessionId': z.string().readonly(),
+  'sessionTitle': z.string().readonly(),
+  'link': z.string().readonly(),
+  'createdAt': z.string().readonly(),
+  'expiresAt': z.string().readonly().optional().describe('ISO time after which the Relay denies viewers; absent means the share never expires.'),
+  'allowsFork': z.boolean().readonly(),
+  'sessionMode': z.union([z.literal("write"), z.literal("view")]).readonly(),
+  'viewerCapabilities': z.array(z.object({
+  'plugin': z.string().readonly().describe('Declaring plugin\'s package name.'),
+  'readable': z.array(z.string()).readonly().describe('Readable endpoints that plugin offers.'),
+  'writable': z.array(z.string()).readonly().describe('Writable endpoints that plugin offers.'),
+})).readonly().describe('Plugin endpoints this share exposes; an empty list means none.'),
+  'online': z.boolean().readonly(),
+  'access': z.object({
+  'mode': z.union([z.literal("open"), z.literal("selected")]).readonly(),
+  'selected': z.array(z.object({
+  'providerId': z.string().readonly(),
+  'tenantId': z.string().readonly(),
+  'subjectId': z.string().readonly(),
+  'identityKey': z.string().readonly(),
+})).readonly(),
+  'deploymentAllowedSubjectIds': z.array(z.string()).readonly(),
+  'shareAllowedSubjectIds': z.array(z.string()).readonly(),
+  'broadenedByDeploymentSubjects': z.boolean().readonly(),
+  'identityKeyAcl': z.literal(true).readonly(),
+}).readonly().optional().describe('Confirmed ACL scope, absent on records written before it was recorded.'),
+})).readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_relay_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_relay_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_relay_result$schema$value ??= z.object({
+  'configured': z.string().readonly().optional().describe('Address a deployment configures directly. Retained so an older Host that still reports one can be read; this build never sets it, because the owner\'s saved address is the only one in force.'),
+  'override': z.string().readonly().optional().describe('Address the owner saved.'),
+  'effective': z.string().readonly().optional().describe('Address new shares publish to; absent while no address is saved.'),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0$schema$value ??= z.object({
+  'shareId': z.string().readonly(),
+  'capabilities': z.array(z.object({
+  'plugin': z.string().readonly().describe('Declaring plugin\'s package name.'),
+  'readable': z.array(z.string()).readonly().describe('Readable endpoints that plugin offers.'),
+  'writable': z.array(z.string()).readonly().describe('Writable endpoints that plugin offers.'),
+})).readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_result$schema$value ??= z.object({
+  'shareId': z.string().readonly(),
+  'viewerCapabilities': z.array(z.object({
+  'plugin': z.string().readonly().describe('Declaring plugin\'s package name.'),
+  'readable': z.array(z.string()).readonly().describe('Readable endpoints that plugin offers.'),
+  'writable': z.array(z.string()).readonly().describe('Writable endpoints that plugin offers.'),
+})).readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0$schema$value ??= z.object({
+  'relayUrl': z.union([z.literal(null), z.string()]).readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_result$schema$value ??= z.object({
+  'configured': z.string().readonly().optional().describe('Address a deployment configures directly. Retained so an older Host that still reports one can be read; this build never sets it, because the owner\'s saved address is the only one in force.'),
+  'override': z.string().readonly().optional().describe('Address the owner saved.'),
+  'effective': z.string().readonly().optional().describe('Address new shares publish to; absent while no address is saved.'),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0$schema$value ??= z.object({
+  'shareId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_result$schema$value ??= z.object({
+  'ok': z.literal(true).readonly(),
+  'relay': z.literal("unreachable").readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0$schema$value ??= z.object({
+  'sessionId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_result$schema$value ??= z.object({
+  'ok': z.boolean().readonly(),
+  'blocking': z.boolean().readonly(),
+  'error': z.string().readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testRelay_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testRelay_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_testRelay_result$schema$value ??= z.object({
+  'ok': z.boolean().readonly(),
+  'httpReachable': z.boolean().readonly().describe('True when the address answered at all, including with a refusal an anonymous request gets.'),
+  'blocking': z.boolean().readonly(),
+  'error': z.string().readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0$schema$value ??= z.object({
+  'shareId': z.string().readonly(),
+  'sessionMode': z.union([z.literal("write"), z.literal("view")]).readonly().optional(),
+  'allowsFork': z.boolean().readonly().optional(),
+  'ttlMinutes': z.union([z.literal(null), z.number()]).readonly().optional().describe('New lifetime in minutes; null clears the deadline and means the share never expires.'),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_result$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_result$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_result$schema$value ??= z.object({
+  'shareId': z.string().readonly(),
+  'sessionMode': z.union([z.literal("write"), z.literal("view")]).readonly(),
+  'allowsFork': z.boolean().readonly(),
+  'expiresAt': z.string().readonly().optional().describe('New deadline; absent means the share never expires.'),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0_strict$schema$value ??= z.strictObject({
+  'shareId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+  'sessionTitle': z.string().readonly().optional().describe('Display title; the Session id is used when this is absent or empty.'),
+  'accessMode': z.union([z.literal("open"), z.literal("selected")]).readonly().optional().describe('Access mode to store with the share. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no access mode, while stored `selected` records and callers that invoke this Remote directly still set it.'),
+  'ttlMinutes': z.number().readonly().optional().describe('Lifetime in minutes; absent means the share never expires.'),
+  'allowedSubjectIds': z.array(z.string()).readonly().optional().describe('Viewers named on a `selected` share, stored beside the deployment\'s allowed subjects. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no subjects.'),
+  'allowsFork': z.boolean().readonly().optional(),
+  'sessionMode': z.union([z.literal("write"), z.literal("view")]).readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0_strict$schema$value ??= z.strictObject({
+  'relay': z.string().readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0_strict$schema$value ??= z.strictObject({
+  'shareId': z.string().readonly(),
+  'capabilities': z.array(z.strictObject({
+  'plugin': z.string().readonly().describe('Declaring plugin\'s package name.'),
+  'readable': z.array(z.string()).readonly().describe('Readable endpoints that plugin offers.'),
+  'writable': z.array(z.string()).readonly().describe('Writable endpoints that plugin offers.'),
+})).readonly().optional(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0_strict$schema$value ??= z.strictObject({
+  'relayUrl': z.union([z.literal(null), z.string()]).readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0_strict$schema$value ??= z.strictObject({
+  'shareId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0_strict$schema = () => (_deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0_strict$schema$value ??= z.strictObject({
+  'shareId': z.string().readonly(),
+  'sessionMode': z.union([z.literal("write"), z.literal("view")]).readonly().optional(),
+  'allowsFork': z.boolean().readonly().optional(),
+  'ttlMinutes': z.union([z.literal(null), z.number()]).readonly().optional().describe('New lifetime in minutes; null clears the deadline and means the share never expires.'),
+}))
+
+export const TYPERT_REMOTE = createTypertRemoteInfo({
+  package: '@deepseek-ai/dsh-experimental-liveshare',
+  methods: {
+    'liveshareShares/audit': {
+      service: 'liveshareShares',
+      description: 'Read the Liveshare server\'s durable audit trail for one share.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Share whose audit is read.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#ShareAuditRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"}},"required":["shareId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#ShareAuditRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"}},"required":["shareId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#ShareAudit',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_audit_result$schema,
+        description: 'The audit events, or a structured failure when the Liveshare server cannot answer.',
+        jsonSchema: {"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"action":{"type":"string"},"createdAt":{"type":"string"},"actor":{"type":"string"},"detail":{}},"required":["id","action","createdAt"],"additionalProperties":true}}},"required":["events"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":132,"column":3},
+    },
+    'liveshareShares/capabilities': {
+      service: 'liveshareShares',
+      description: 'Read the endpoints plugins currently offer.',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#ShareCapabilityOffers',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_capabilities_result$schema,
+        description: 'The live offer list.',
+        jsonSchema: {"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"plugin":{"type":"string","description":"Declaring plugin's package name."},"readable":{"type":"array","items":{"type":"string"},"description":"Readable endpoints that plugin offers."},"writable":{"type":"array","items":{"type":"string"},"description":"Writable endpoints that plugin offers."}},"required":["plugin","readable","writable"],"additionalProperties":true}}},"required":["capabilities"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":99,"column":3},
+    },
+    'liveshareShares/create': {
+      service: 'liveshareShares',
+      description: 'Publish one Session and store the share.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Session, title, access, lifetime, and both switches the owner chose.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#CreateShareRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"sessionTitle":{"type":"string","description":"Display title; the Session id is used when this is absent or empty."},"accessMode":{"type":"string","enum":["open","selected"],"description":"Access mode to store with the share. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no access mode, while stored `selected` records and callers that invoke this Remote directly still set it."},"ttlMinutes":{"type":"number","description":"Lifetime in minutes; absent means the share never expires."},"allowedSubjectIds":{"type":"array","items":{"type":"string"},"description":"Viewers named on a `selected` share, stored beside the deployment's allowed subjects. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no subjects."},"allowsFork":{"type":"boolean"},"sessionMode":{"type":"string","enum":["write","view"]}},"required":["sessionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#CreateShareRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"sessionTitle":{"type":"string","description":"Display title; the Session id is used when this is absent or empty."},"accessMode":{"type":"string","enum":["open","selected"],"description":"Access mode to store with the share. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no access mode, while stored `selected` records and callers that invoke this Remote directly still set it."},"ttlMinutes":{"type":"number","description":"Lifetime in minutes; absent means the share never expires."},"allowedSubjectIds":{"type":"array","items":{"type":"string"},"description":"Viewers named on a `selected` share, stored beside the deployment's allowed subjects. Legacy and direct-API use only: the shipped Share dialog creates `open` shares and sends no subjects."},"allowsFork":{"type":"boolean"},"sessionMode":{"type":"string","enum":["write","view"]}},"required":["sessionId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#CreatedShare',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_create_result$schema,
+        description: 'The created share\'s link and stored values.',
+        jsonSchema: {"type":"object","properties":{"link":{"type":"string"},"shareId":{"type":"string"},"sessionId":{"type":"string"},"sessionMode":{"type":"string","enum":["write","view"]},"access":{"type":"object","properties":{"mode":{"type":"string","enum":["open","selected"]},"selected":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"tenantId":{"type":"string"},"subjectId":{"type":"string"},"identityKey":{"type":"string"}},"required":["providerId","tenantId","subjectId","identityKey"],"additionalProperties":true}},"deploymentAllowedSubjectIds":{"type":"array","items":{"type":"string"}},"shareAllowedSubjectIds":{"type":"array","items":{"type":"string"}},"broadenedByDeploymentSubjects":{"type":"boolean"},"identityKeyAcl":{"type":"boolean","const":true}},"required":["mode","selected","deploymentAllowedSubjectIds","shareAllowedSubjectIds","broadenedByDeploymentSubjects","identityKeyAcl"],"additionalProperties":true}},"required":["link","shareId","sessionId","sessionMode","access"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":57,"column":3},
+    },
+    'liveshareShares/identity': {
+      service: 'liveshareShares',
+      description: 'Report this host\'s owner identity for one Liveshare server address.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Address to report, or the effective one when absent.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#OwnerIdentityRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"relay":{"type":"string"}},"required":[],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#OwnerIdentityRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"relay":{"type":"string"}},"required":[],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#OwnerIdentityStatus',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_identity_result$schema,
+        description: 'The owner identity status, without the credential.',
+        jsonSchema: {"type":"object","properties":{"state":{"type":"string","enum":["expired","verified","unverified","relay-unsupported"]},"relay":{"type":"string","description":"Relay base URL the credential is bound to. A host keeps one credential per Relay address and never presents it to another, so a viewer of this field compares it with the active address."},"displayName":{"type":"string","description":"Provider display name, when the credential carries one."},"subjectId":{"type":"string","description":"Verified subject id, which a client may show as the identity label."},"avatarUrl":{"type":"string","description":"Provider-issued avatar URL the credential carried, when it carried one."},"expiresAt":{"type":"string","description":"ISO expiry of the credential currently held."},"renewed":{"type":"boolean","description":"True when this report followed a renewal that pushed the expiry out."},"claim":{"type":"object","properties":{"claimed":{"type":"number","description":"Shares the Relay bound to this identity."},"skipped":{"type":"number","description":"Shares already bound to this identity, so the Relay left them untouched."}},"required":["claimed","skipped"],"additionalProperties":true,"description":"Automatic claim result, present once this host has run a claim pass."}},"required":["state","relay"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":122,"column":3},
+    },
+    'liveshareShares/list': {
+      service: 'liveshareShares',
+      description: 'Refresh titles and Liveshare server authority, then list this host\'s shares.',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#OwnerShareList',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_list_result$schema,
+        description: 'Every share this host publishes.',
+        jsonSchema: {"type":"object","properties":{"shares":{"type":"array","items":{"type":"object","properties":{"shareId":{"type":"string"},"sessionId":{"type":"string"},"sessionTitle":{"type":"string"},"link":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string","description":"ISO time after which the Relay denies viewers; absent means the share never expires."},"allowsFork":{"type":"boolean"},"sessionMode":{"type":"string","enum":["write","view"]},"viewerCapabilities":{"type":"array","items":{"type":"object","properties":{"plugin":{"type":"string","description":"Declaring plugin's package name."},"readable":{"type":"array","items":{"type":"string"},"description":"Readable endpoints that plugin offers."},"writable":{"type":"array","items":{"type":"string"},"description":"Writable endpoints that plugin offers."}},"required":["plugin","readable","writable"],"additionalProperties":true},"description":"Plugin endpoints this share exposes; an empty list means none."},"online":{"type":"boolean"},"access":{"type":"object","properties":{"mode":{"type":"string","enum":["open","selected"]},"selected":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string"},"tenantId":{"type":"string"},"subjectId":{"type":"string"},"identityKey":{"type":"string"}},"required":["providerId","tenantId","subjectId","identityKey"],"additionalProperties":true}},"deploymentAllowedSubjectIds":{"type":"array","items":{"type":"string"}},"shareAllowedSubjectIds":{"type":"array","items":{"type":"string"}},"broadenedByDeploymentSubjects":{"type":"boolean"},"identityKeyAcl":{"type":"boolean","const":true}},"required":["mode","selected","deploymentAllowedSubjectIds","shareAllowedSubjectIds","broadenedByDeploymentSubjects","identityKeyAcl"],"additionalProperties":true,"description":"Confirmed ACL scope, absent on records written before it was recorded."}},"required":["shareId","sessionId","sessionTitle","link","createdAt","allowsFork","sessionMode","viewerCapabilities","online"],"additionalProperties":true}}},"required":["shares"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":64,"column":3},
+    },
+    'liveshareShares/relay': {
+      service: 'liveshareShares',
+      description: 'Read the Liveshare server address the owner saved.',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#OwnerRelayState',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_relay_result$schema,
+        description: 'The current Liveshare server state, with both address fields absent while none is saved.',
+        jsonSchema: {"type":"object","properties":{"configured":{"type":"string","description":"Address a deployment configures directly. Retained so an older Host that still reports one can be read; this build never sets it, because the owner's saved address is the only one in force."},"override":{"type":"string","description":"Address the owner saved."},"effective":{"type":"string","description":"Address new shares publish to; absent while no address is saved."}},"required":[],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":106,"column":3},
+    },
+    'liveshareShares/setCapabilities': {
+      service: 'liveshareShares',
+      description: 'Replace one share\'s exposed plugin endpoints.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Share and the selection to store.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#SetShareCapabilitiesRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"},"capabilities":{"type":"array","items":{"type":"object","properties":{"plugin":{"type":"string","description":"Declaring plugin's package name."},"readable":{"type":"array","items":{"type":"string"},"description":"Readable endpoints that plugin offers."},"writable":{"type":"array","items":{"type":"string"},"description":"Writable endpoints that plugin offers."}},"required":["plugin","readable","writable"],"additionalProperties":true}}},"required":["shareId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#SetShareCapabilitiesRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"},"capabilities":{"type":"array","items":{"type":"object","properties":{"plugin":{"type":"string","description":"Declaring plugin's package name."},"readable":{"type":"array","items":{"type":"string"},"description":"Readable endpoints that plugin offers."},"writable":{"type":"array","items":{"type":"string"},"description":"Writable endpoints that plugin offers."}},"required":["plugin","readable","writable"],"additionalProperties":false}}},"required":["shareId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#ShareCapabilities',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setCapabilities_result$schema,
+        description: 'The capability selection the share now carries.',
+        jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"},"viewerCapabilities":{"type":"array","items":{"type":"object","properties":{"plugin":{"type":"string","description":"Declaring plugin's package name."},"readable":{"type":"array","items":{"type":"string"},"description":"Readable endpoints that plugin offers."},"writable":{"type":"array","items":{"type":"string"},"description":"Writable endpoints that plugin offers."}},"required":["plugin","readable","writable"],"additionalProperties":true}}},"required":["shareId","viewerCapabilities"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":90,"column":3},
+    },
+    'liveshareShares/setRelay': {
+      service: 'liveshareShares',
+      description: 'Choose the Liveshare server address later shares publish to.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Normalized address or null to clear the saved one.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#SetRelayRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"relayUrl":{"oneOf":[{"type":"null","const":null},{"type":"string"}]}},"required":["relayUrl"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#SetRelayRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"relayUrl":{"oneOf":[{"type":"null","const":null},{"type":"string"}]}},"required":["relayUrl"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#OwnerRelayState',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_setRelay_result$schema,
+        description: 'The Liveshare server state after the change.',
+        jsonSchema: {"type":"object","properties":{"configured":{"type":"string","description":"Address a deployment configures directly. Retained so an older Host that still reports one can be read; this build never sets it, because the owner's saved address is the only one in force."},"override":{"type":"string","description":"Address the owner saved."},"effective":{"type":"string","description":"Address new shares publish to; absent while no address is saved."}},"required":[],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":114,"column":3},
+    },
+    'liveshareShares/stop': {
+      service: 'liveshareShares',
+      description: 'Stop one share locally, revoke its forks, and delete its row on the Liveshare server when reachable.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Share to stop.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#StopShareRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"}},"required":["shareId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#StopShareRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"}},"required":["shareId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#StopShareResult',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_stop_result$schema,
+        description: 'Whether the row on the Liveshare server still needs a retry.',
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean","const":true},"relay":{"type":"string","const":"unreachable"}},"required":["ok"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":72,"column":3},
+    },
+    'liveshareShares/testPublish': {
+      service: 'liveshareShares',
+      description: 'Register one throwaway share to check whether this host may publish.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Session the throwaway registration names.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#TestPublishRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#TestPublishRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#RelayPublishView',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testPublish_result$schema,
+        description: 'The Liveshare server\'s decision about this host\'s credential.',
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean"},"blocking":{"type":"boolean"},"error":{"type":"string"}},"required":["ok","blocking"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":147,"column":3},
+    },
+    'liveshareShares/testRelay': {
+      service: 'liveshareShares',
+      description: 'Check that the effective Liveshare server answers at all.',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#RelayConnectivityView',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_testRelay_result$schema,
+        description: 'The anonymous connectivity result.',
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean"},"httpReachable":{"type":"boolean","description":"True when the address answered at all, including with a refusal an anonymous request gets."},"blocking":{"type":"boolean"},"error":{"type":"string"}},"required":["ok","httpReachable","blocking"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":139,"column":3},
+    },
+    'liveshareShares/updatePermissions': {
+      service: 'liveshareShares',
+      description: 'Change one share\'s tier, fork switch, or both.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          description: 'Share and the switches to change.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#UpdateSharePermissionsRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"},"sessionMode":{"type":"string","enum":["write","view"]},"allowsFork":{"type":"boolean"},"ttlMinutes":{"oneOf":[{"type":"null","const":null},{"type":"number"}],"description":"New lifetime in minutes; null clears the deadline and means the share never expires."}},"required":["shareId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#UpdateSharePermissionsRequest',
+            create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"},"sessionMode":{"type":"string","enum":["write","view"]},"allowsFork":{"type":"boolean"},"ttlMinutes":{"oneOf":[{"type":"null","const":null},{"type":"number"}],"description":"New lifetime in minutes; null clears the deadline and means the share never expires."}},"required":["shareId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-experimental-liveshare/types#SharePermissions',
+        create: _deepseek_ai_dsh_experimental_liveshare_liveshareShares_updatePermissions_result$schema,
+        description: 'The permissions the share now carries.',
+        jsonSchema: {"type":"object","properties":{"shareId":{"type":"string"},"sessionMode":{"type":"string","enum":["write","view"]},"allowsFork":{"type":"boolean"},"expiresAt":{"type":"string","description":"New deadline; absent means the share never expires."}},"required":["shareId","sessionMode","allowsFork"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/experimental/liveshare/src/host/share-remote.ts","line":80,"column":3},
+    },
+  },
+}, z)
+
+export default TYPERT_REMOTE

package/lib/types/client/ManageSharesDialog.d.ts

@@ -0,0 +1,21 @@
+/** Global owner-side list of shares; each row opens that Session's share dialog. */
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { NS } from './locales.ts';
+import type { OwnerShares } from './owner-shares.ts';
+/** Props for the global Liveshare share manager. */
+export interface LiveshareManageSharesDialogProps extends PropsLocale<typeof NS> {
+    /** Owner share management, addressed through the generated `liveshareShares` namespace. */
+    readonly shares: OwnerShares;
+    /** Open the share dialog for one Session. */
+    readonly onOpenShare?: (sessionId: string, sessionTitle: string) => void;
+    /** Close the manager. */
+    readonly onClose: () => void;
+}
+/**
+ * List every share and open the one whose Session the owner wants to manage.
+ * @param props - Owner shares, navigation callback, close callback, and copy.
+ * @returns The manager modal.
+ */
+export declare function LiveshareManageSharesDialog({ shares, onOpenShare, onClose, t }: LiveshareManageSharesDialogProps): ReactNode;
+//# sourceMappingURL=ManageSharesDialog.d.ts.map

package/lib/types/client/ShareAction.d.ts

@@ -0,0 +1,19 @@
+/** Session-header action that opens the Liveshare owner-side share dialog. */
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { NS } from './locales.ts';
+import type { OwnerShares } from './owner-shares.ts';
+/** Business face the header action receives: the owner's share-management Remote. */
+export interface LiveshareShareActionInjected {
+    /** Owner share management, addressed through the generated `liveshareShares` namespace. */
+    readonly shares: OwnerShares;
+}
+/** Full props for the Liveshare Session-header utility. */
+export type LiveshareShareActionProps = PropsRuntime<'conversation.session.header.utilities'> & InjectFace<LiveshareShareActionInjected> & PropsLocale<typeof NS>;
+/**
+ * Render the Session Header Share action and its dialog for a local owner.
+ * @param props - Session runtime plus localized copy.
+ * @returns the header action and optional dialog.
+ */
+export declare function LiveshareShareAction({ sessionId, useSessions, shares, t }: LiveshareShareActionProps): ReactNode;
+//# sourceMappingURL=ShareAction.d.ts.map