@cleanslate/sdk 1.0.11 → 1.1.0

package/dist/tools/cleanSlateBrowserPolicy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Browser policy is defined beside the capability and adapted by each host.
+ * This keeps the built-in agent, external agents, and the advertised tool
+ * catalog aligned without making any one prompt surface the source of truth.
+ */
+export declare const CLEANSLATE_BROWSER_POLICY: Readonly<{
+    activation: "Use browser_* tools only when the current user request explicitly asks to open a browser, preview a page, inspect the DOM, capture screenshots, or perform visual/browser verification.";
+    incidentalUiChanges: "Do not open the browser, collect browser evidence, or require browser verification only because UI files changed.";
+    nonBrowserVerification: "When browser verification was not explicitly requested, rely on code inspection, diagnostics, tests, and concise completion reporting instead.";
+    boundSurface: "When browser work is requested, use the browser tools bound to the current CleanSlate chat; they operate the user's visible CleanSlate browser.";
+    noSilentFallback: "Do not substitute another browser, OS shell opener, or browser-automation environment unless the user explicitly requests that destination. If a required browser capability is unavailable or fails, report it instead of silently switching.";
+}>;
+export declare function getCleanSlateBrowserOptInLines(): readonly string[];
+export declare function getCleanSlateBrowserHostPolicy(): string;
+export declare function applyCleanSlateBrowserToolPolicy<T extends {
+    readonly category?: string;
+    readonly description: string;
+}>(tool: T): T;
+//# sourceMappingURL=cleanSlateBrowserPolicy.d.ts.map

package/dist/tools/cleanSlateBrowserPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateBrowserPolicy.d.ts","sourceRoot":"","sources":["../../src/tools/cleanSlateBrowserPolicy.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;EAMpC,CAAC;AAEH,wBAAgB,8BAA8B,IAAI,SAAS,MAAM,EAAE,CAMlE;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD;AAED,wBAAgB,gCAAgC,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAMnI"}

package/dist/tools/cleanSlateBrowserPolicy.js

@@ -0,0 +1,40 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+/**
+ * Browser policy is defined beside the capability and adapted by each host.
+ * This keeps the built-in agent, external agents, and the advertised tool
+ * catalog aligned without making any one prompt surface the source of truth.
+ */
+export const CLEANSLATE_BROWSER_POLICY = Object.freeze({
+    activation: 'Use browser_* tools only when the current user request explicitly asks to open a browser, preview a page, inspect the DOM, capture screenshots, or perform visual/browser verification.',
+    incidentalUiChanges: 'Do not open the browser, collect browser evidence, or require browser verification only because UI files changed.',
+    nonBrowserVerification: 'When browser verification was not explicitly requested, rely on code inspection, diagnostics, tests, and concise completion reporting instead.',
+    boundSurface: 'When browser work is requested, use the browser tools bound to the current CleanSlate chat; they operate the user\'s visible CleanSlate browser.',
+    noSilentFallback: 'Do not substitute another browser, OS shell opener, or browser-automation environment unless the user explicitly requests that destination. If a required browser capability is unavailable or fails, report it instead of silently switching.'
+});
+export function getCleanSlateBrowserOptInLines() {
+    return [
+        CLEANSLATE_BROWSER_POLICY.activation,
+        CLEANSLATE_BROWSER_POLICY.incidentalUiChanges,
+        CLEANSLATE_BROWSER_POLICY.nonBrowserVerification
+    ];
+}
+export function getCleanSlateBrowserHostPolicy() {
+    return [
+        ...getCleanSlateBrowserOptInLines(),
+        CLEANSLATE_BROWSER_POLICY.boundSurface,
+        CLEANSLATE_BROWSER_POLICY.noSilentFallback
+    ].join(' ');
+}
+export function applyCleanSlateBrowserToolPolicy(tool) {
+    if (tool.category !== 'browser') {
+        return tool;
+    }
+    return {
+        ...tool,
+        description: `${tool.description} Request scope: ${CLEANSLATE_BROWSER_POLICY.activation} ${CLEANSLATE_BROWSER_POLICY.incidentalUiChanges}`
+    };
+}
+//# sourceMappingURL=cleanSlateBrowserPolicy.js.map

package/dist/tools/cleanSlateBrowserPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateBrowserPolicy.js","sourceRoot":"","sources":["../../src/tools/cleanSlateBrowserPolicy.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,UAAU,EAAE,yLAAyL;IACrM,mBAAmB,EAAE,mHAAmH;IACxI,sBAAsB,EAAE,gJAAgJ;IACxK,YAAY,EAAE,kJAAkJ;IAChK,gBAAgB,EAAE,gPAAgP;CAClQ,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B;IAC7C,OAAO;QACN,yBAAyB,CAAC,UAAU;QACpC,yBAAyB,CAAC,mBAAmB;QAC7C,yBAAyB,CAAC,sBAAsB;KAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC7C,OAAO;QACN,GAAG,8BAA8B,EAAE;QACnC,yBAAyB,CAAC,YAAY;QACtC,yBAAyB,CAAC,gBAAgB;KAC1C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAyE,IAAO;IAC/H,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IACjD,OAAO;QACN,GAAG,IAAI;QACP,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,mBAAmB,yBAAyB,CAAC,UAAU,IAAI,yBAAyB,CAAC,mBAAmB,EAAE;KAC1I,CAAC;AACH,CAAC"}

package/dist/tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA2DnE,eAAO,MAAM,SAAS,EAAE,cAAc,EAgErC,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,CAI5G"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA8HnE,eAAO,MAAM,SAAS,EAAE,cAAc,EAA0D,CAAC;AAEjG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,CAI5G"}

package/dist/tools/registry.js

@@ -32,7 +32,8 @@ import { mcpCallTool, mcpListToolsTool } from './MCPTools.js';
 import { listSkillsTool } from './SkillTools.js';
 import { webFetchTool, webSearchTool } from './WebRetrievalTools.js';
 import { browserClickTool, browserCheckTool, browserClipboardTool, browserCloseTabTool, browserClearAnnotationsTool, browserDeleteAnnotationTool, browserDiagnosticsTool, browserDialogTool, browserFillTool, browserGetUrlTool, browserHoverTool, browserKeyTool, browserListAnnotationsTool, browserNewTabTool, browserOpenTool, browserScreenshotTool, browserScrollTool, browserSelectTool, browserSelectTabTool, browserSnapshotTool, browserStartAnnotationTool, browserStopAnnotationTool, browserTabsTool, browserTypeTool, browserUploadTool, browserWaitTool } from './BrowserAutomationTools.js';
-export const ALL_TOOLS = [
+import { applyCleanSlateBrowserToolPolicy } from './cleanSlateBrowserPolicy.js';
+const cleanSlateTools = [
     readFileTool,
     readFileRangeTool,
     semanticSearchTool,
@@ -97,6 +98,7 @@ export const ALL_TOOLS = [
     undoEditTool,
     fileHistoryRewindTool
 ];
+export const ALL_TOOLS = cleanSlateTools.map(applyCleanSlateBrowserToolPolicy);
 export function getToolByName(name) {
     return ALL_TOOLS.find(tool => tool.name === name);
 }

package/dist/tools/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleanslate/sdk",
-  "version": "1.0.11",
+  "version": "1.1.0",
   "description": "Slate agent runtime: execution loop, tool protocol, edit engine and Node host.",
   "license": "MIT",
   "type": "module",