@khorsheed/dsh-context-guard 0.1.0

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@khorsheed/dsh-context-guard`.
+ * @module @khorsheed/dsh-context-guard/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "context-guard-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,4BAA4B,CAAA;AAC7C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AAWpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAS,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/types/invariant.js

@@ -0,0 +1,24 @@
+/**
+ * Package-owned invariant companion for `@khorsheed/dsh-context-guard`.
+ * @module @khorsheed/dsh-context-guard/invariant
+ */
+const PACKAGE_NAME = '@khorsheed/dsh-context-guard';
+/** Cordis companion plugin name. */
+export const name = 'context-guard-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: every compact action is executed through the official
+ * `/compact` command channel, whose command-log invariant companion audits the
+ * command lifecycle, and the plugin's one composer-tool-row entry proves
+ * disposal through the browser-plugin spec. No second authority exists to
+ * check at runtime.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */

package/lib/types/namespace.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The settings namespace owned by the context-guard plugin. Plain string so
+ * both the host half (settings registration) and the browser half
+ * (settingsScope binding and the settings.plugin.item card key) import it
+ * without dragging host-only dependencies into the client bundle.
+ */
+/** Settings namespace owned by the context-guard plugin. */
+export declare const CONTEXT_GUARD_NS = "context-guard";
+//# sourceMappingURL=namespace.d.ts.map

package/lib/types/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/namespace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,kBAAkB,CAAA"}

package/lib/types/namespace.js

@@ -0,0 +1,8 @@
+/**
+ * The settings namespace owned by the context-guard plugin. Plain string so
+ * both the host half (settings registration) and the browser half
+ * (settingsScope binding and the settings.plugin.item card key) import it
+ * without dragging host-only dependencies into the client bundle.
+ */
+/** Settings namespace owned by the context-guard plugin. */
+export const CONTEXT_GUARD_NS = 'context-guard';

package/lib/types/settings.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Host-side settings section of the context-guard plugin: the schemastery
+ * schema that validates the `context-guard` settings namespace. The browser
+ * half reads the resolved section through `ctx.settingsScope` and the
+ * settings page renders it as a plugin card; the composition entry (the
+ * cordis.yml row) becomes the section's `base` layer, so YAML values keep
+ * working as the defaults the card can override.
+ *
+ * These two fields tune ONLY when the compact button appears — the official
+ * compaction engine (compaction-basic) reads its own `thresholdRatio` /
+ * `maxTokens` config and never touches this section.
+ */
+import z from '@deepseek-ai/schemastery';
+/** Section shape: the context-occupancy fraction at which the button appears. */
+export declare const ContextGuardSettingsSchema: z<Schemastery.ObjectS<{
+    thresholdRatio: z<number, number>;
+}>, Schemastery.ObjectT<{
+    thresholdRatio: z<number, number>;
+}>>;
+//# sourceMappingURL=settings.d.ts.map

package/lib/types/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,iFAAiF;AACjF,eAAO,MAAM,0BAA0B;;;;GAErC,CAAA"}

package/lib/types/settings.js

@@ -0,0 +1,17 @@
+/**
+ * Host-side settings section of the context-guard plugin: the schemastery
+ * schema that validates the `context-guard` settings namespace. The browser
+ * half reads the resolved section through `ctx.settingsScope` and the
+ * settings page renders it as a plugin card; the composition entry (the
+ * cordis.yml row) becomes the section's `base` layer, so YAML values keep
+ * working as the defaults the card can override.
+ *
+ * These two fields tune ONLY when the compact button appears — the official
+ * compaction engine (compaction-basic) reads its own `thresholdRatio` /
+ * `maxTokens` config and never touches this section.
+ */
+import z from '@deepseek-ai/schemastery';
+/** Section shape: the context-occupancy fraction at which the button appears. */
+export const ContextGuardSettingsSchema = z.object({
+    thresholdRatio: z.number().min(0.01).max(1).default(0.8),
+});

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@khorsheed/dsh-context-guard",
+  "description": "Context-window compaction reminder: a compact button appears in the composer once context occupancy (the same number the context ring shows) crosses a configurable fraction of the model's context window, so you can compact before requests hit the provider's rejection wall (which sits below 100% occupancy because the request reserves output tokens)",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "cordis",
+    "context",
+    "compaction"
+  ],
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-primitives",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    },
+    "compat": {
+      "minHost": "0.1.0-rc.8",
+      "verifiedHost": "0.1.1-rc.2"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-token-meter": "^0.1.0-rc.6",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-token-meter": "^0.1.1-rc.1",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "LICENSE",
+    "CHANGELOG.md"
+  ]
+}