dsh-modellix 0.1.0

package/lib/client.d.ts

@@ -0,0 +1,214 @@
+
+import { ClientContext } from "@deepseek-ai/dsh-client-runtime/client";
+
+//#region src/shared/design-presentation-codes.d.ts
+declare const DESIGN_NOTICE_CODES: readonly ["schema-unavailable", "schema-invalid", "catalog-stale", "catalog-unavailable", "credential-reloaded"];
+type DesignNoticeCode = (typeof DESIGN_NOTICE_CODES)[number];
+declare const DESIGN_MODEL_UNAVAILABLE_CODES: readonly ["removed-from-catalog"];
+type DesignModelUnavailableCode = (typeof DESIGN_MODEL_UNAVAILABLE_CODES)[number];
+declare const DESIGN_FIELD_DISABLED_CODES: readonly ["unsupported-schema-field"];
+type DesignFieldDisabledCode = (typeof DESIGN_FIELD_DISABLED_CODES)[number];
+declare const DESIGN_DIAGNOSTIC_CODES: readonly ["credential-changed", "submit-unknown", "generation-failed", "result-unavailable", "credential-rejected", "task-inaccessible", "rate-limited", "response-invalid", "poll-unavailable"];
+type DesignDiagnosticCode = (typeof DESIGN_DIAGNOSTIC_CODES)[number];
+//#endregion
+//#region src/client/contracts.d.ts
+declare const MODELLIX_CLIENT_WIRE_VERSION: 1;
+declare const MODELLIX_RPC_CHANNEL: "/modellix";
+declare const MODELLIX_RPC_ENDPOINTS: Readonly<{
+  stateGet: "state/get";
+  credentialSave: "credential/save";
+  onboardingDefer: "onboarding/defer";
+  settingsToggles: "settings/toggles";
+  credentialRemove: "credential/remove";
+  llmRefresh: "llm/refresh";
+  designRead: "design/read";
+  designRefresh: "design/refresh";
+  designSelectModel: "design/select-model";
+  designPropose: "design/propose";
+  designProposalApply: "design/proposal/apply";
+  designProposalReject: "design/proposal/reject";
+  designSubmit: "design/submit";
+}>;
+type ModellixRpcEndpoint = (typeof MODELLIX_RPC_ENDPOINTS)[keyof typeof MODELLIX_RPC_ENDPOINTS];
+interface ServiceTogglesWire {
+  readonly design: boolean;
+  readonly llm: boolean;
+  readonly web: boolean;
+}
+type CredentialVerificationWire = "unknown" | "unverified" | "valid" | "invalid";
+interface CredentialDescriptorWire {
+  readonly configured: boolean;
+  readonly source: "local" | "env" | null;
+  readonly writable: boolean;
+  /** Opaque Host descriptor token. The Client may echo it for CAS but never renders it. */
+  readonly revision: string | null;
+  readonly credentialEpoch: number;
+  readonly verification: CredentialVerificationWire;
+  readonly invalidEpoch: number | null;
+}
+interface SettingsSnapshotWire {
+  readonly version: 1;
+  readonly settingsRevision: number;
+  readonly services: ServiceTogglesWire;
+  readonly credential: CredentialDescriptorWire;
+  readonly onboarding: {
+    readonly status: "active" | "completed" | "deferred";
+    readonly recoveryPending: boolean;
+    readonly recoveryRequestId: string | null;
+  };
+  readonly llm: {
+    readonly health: "unknown" | "missing" | "disabled" | "ready" | "error" | "policy-blocked";
+    readonly modelCount: number;
+    readonly refreshedAt: number | null;
+  };
+}
+type ClientJsonValue = null | boolean | number | string | readonly ClientJsonValue[] | {
+  readonly [key: string]: ClientJsonValue;
+};
+interface DesignModelWire {
+  readonly id: string;
+  readonly label: string;
+  readonly kind: "image" | "video" | "audio" | "unknown";
+  readonly featured: boolean;
+  readonly available: boolean;
+  readonly unavailableReason: DesignModelUnavailableCode | null;
+}
+interface DesignEnumOptionWire {
+  readonly label: string;
+  readonly value: string | number | boolean;
+}
+interface DesignFieldWire {
+  readonly path: string;
+  readonly label: string;
+  readonly description: string | null;
+  readonly kind: "string" | "number" | "integer" | "boolean" | "enum" | "array" | "object" | "media";
+  readonly widget: "input" | "textarea" | "select" | "switch" | "json" | "media";
+  readonly required: boolean;
+  readonly options: readonly DesignEnumOptionWire[];
+  readonly minimum: number | null;
+  readonly maximum: number | null;
+  readonly step: number | null;
+  readonly maxLength: number | null;
+  readonly disabledReason: DesignFieldDisabledCode | null;
+}
+interface DesignDraftWire {
+  readonly modelId: string;
+  readonly draftRevision: number;
+  readonly irContractHash: string;
+  readonly primaryInputPath: string;
+  readonly fields: readonly DesignFieldWire[];
+  /** Flattened IR field path -> JSON value. The Host revalidates before submit. */
+  readonly parameters: Readonly<Record<string, ClientJsonValue>>;
+}
+interface DesignProposalChangeWire {
+  readonly path: string;
+  readonly label: string;
+  readonly before: ClientJsonValue | undefined;
+  readonly after: ClientJsonValue | undefined;
+}
+interface DesignProposalWire {
+  readonly proposalId: string;
+  readonly baseDraftRevision: number;
+  readonly summary: string;
+  readonly changes: readonly DesignProposalChangeWire[];
+  readonly conflicts: readonly string[];
+}
+interface DesignResourceWire {
+  readonly id: string;
+  readonly kind: "image" | "video" | "audio";
+  readonly url: string;
+  readonly downloadUrl: string;
+  readonly expiresAt: string | null;
+}
+interface DesignDiagnosticWire {
+  readonly code: DesignDiagnosticCode;
+  readonly retryable: boolean;
+}
+interface DesignJobWire {
+  readonly jobId: string;
+  readonly modelId: string;
+  readonly status: "running" | "succeeded" | "failed" | "canceled" | "submit-unknown" | "expired";
+  readonly createdAt: string;
+  readonly updatedAt: string;
+  readonly resources: readonly DesignResourceWire[];
+  readonly diagnostic: DesignDiagnosticWire | null;
+}
+interface DesignSnapshotWire {
+  readonly version: 1;
+  readonly enabled: boolean;
+  readonly credentialReady: boolean;
+  readonly models: readonly DesignModelWire[];
+  readonly selectedModelId: string | null;
+  readonly draft: DesignDraftWire | null;
+  readonly proposal: DesignProposalWire | null;
+  readonly jobs: readonly DesignJobWire[];
+  readonly notice: DesignNoticeCode | null;
+}
+type DesignMutationWire = {
+  readonly version: 1;
+  readonly accepted: true;
+  readonly state: DesignSnapshotWire;
+} | {
+  readonly version: 1;
+  readonly accepted: false;
+  readonly code: string;
+};
+interface AckWire {
+  readonly version: 1;
+  readonly accepted: true;
+}
+type SettingsMutationWire = {
+  readonly version: 1;
+  readonly accepted: true;
+  readonly state: SettingsSnapshotWire;
+} | {
+  readonly version: 1;
+  readonly accepted: false;
+  readonly code: "credential-changed" | "settings-changed";
+  readonly messageKey: null;
+  readonly state: SettingsSnapshotWire;
+} | {
+  readonly version: 1;
+  readonly accepted: false;
+  readonly code: string;
+  readonly messageKey: string;
+  readonly state: null;
+};
+declare class ModellixClientContractError extends Error {
+  constructor(message: string);
+}
+declare function parseSettingsSnapshot(input: unknown): SettingsSnapshotWire;
+declare function parseDesignSnapshot(input: unknown): DesignSnapshotWire;
+declare function parseDesignMutation(input: unknown): DesignMutationWire;
+declare function parseAck(input: unknown): AckWire;
+declare function parseSettingsMutation(input: unknown): SettingsMutationWire;
+declare function sanitizeParameters(input: Readonly<Record<string, ClientJsonValue>>): Readonly<Record<string, ClientJsonValue>>;
+declare function safeResourceHref(value: string): string;
+//#endregion
+//#region src/client/registration.d.ts
+declare const MODELLIX_CLIENT_SLOTS: readonly [{
+  readonly name: "shell.overlay";
+  readonly id: "modellix.credential-recovery";
+  readonly order: 10;
+}, {
+  readonly name: "settings.onboarding";
+  readonly id: "modellix.onboarding";
+  readonly order: 10;
+}, {
+  readonly name: "settings.section";
+  readonly id: "modellix";
+  readonly order: 30;
+}, {
+  readonly name: "conversation.view";
+  readonly id: "modellix.design";
+  readonly order: 20;
+}];
+type ModellixClientSlotDefinition = (typeof MODELLIX_CLIENT_SLOTS)[number];
+//#endregion
+//#region src/client/index.d.ts
+declare const inject: string[];
+declare function apply(ctx: ClientContext): void;
+//#endregion
+export { AckWire, ClientJsonValue, CredentialDescriptorWire, CredentialVerificationWire, DesignDiagnosticWire, DesignDraftWire, DesignEnumOptionWire, DesignFieldWire, DesignJobWire, DesignModelWire, DesignMutationWire, DesignProposalChangeWire, DesignProposalWire, DesignResourceWire, DesignSnapshotWire, MODELLIX_CLIENT_SLOTS, MODELLIX_CLIENT_WIRE_VERSION, MODELLIX_RPC_CHANNEL, MODELLIX_RPC_ENDPOINTS, ModellixClientContractError, ModellixClientSlotDefinition, ModellixRpcEndpoint, ServiceTogglesWire, SettingsMutationWire, SettingsSnapshotWire, apply, inject, parseAck, parseDesignMutation, parseDesignSnapshot, parseSettingsMutation, parseSettingsSnapshot, safeResourceHref, sanitizeParameters };
+
+//# sourceMappingURL=client.d.ts.map