@qvac/harness 0.2.9 → 0.2.12

package/dist-lib/lib/tools/skills/manifest.d.ts

@@ -29,6 +29,17 @@ export interface SkillSetupField {
     readonly secret?: boolean;
     readonly required?: boolean;
 }
+export interface SkillOAuthConfig {
+    readonly stateKey: string;
+    readonly authUrl: string;
+    readonly tokenUrl: string;
+    readonly scopes: readonly string[];
+    readonly tokenAuth: 'pkce-only' | 'secret-in-body' | 'secret-in-basic';
+    readonly extraAuthParams?: Readonly<Record<string, string>>;
+    readonly registrationEndpoint?: string;
+    readonly port?: number;
+    readonly sharedIosSession?: boolean;
+}
 export interface SkillSetupRoute {
     readonly kind: 'oauth' | 'token' | 'install' | 'picker' | 'instructions';
     readonly label: string;
@@ -40,6 +51,7 @@ export interface SkillSetupRoute {
     readonly configSteps?: readonly string[];
     readonly fields?: readonly SkillSetupField[];
     readonly satisfied?: boolean;
+    readonly oauth?: SkillOAuthConfig;
 }
 export interface SkillSetup {
     readonly summary?: string;

package/dist-lib/lib/tools/toolsets.d.ts

@@ -4,5 +4,6 @@ export declare function asToolset(value?: string | null): Toolset | null;
 export interface ToolsetScoped {
     toolset?: string | null;
 }
+export declare const NETWORK_TOOLSETS: ReadonlyArray<Toolset>;
 export declare function permittedTools<T extends ToolsetScoped>(tools: ReadonlyArray<T>, disabled?: ReadonlyArray<string> | null): T[];
 export declare function toolsetEnabled(toolset: Toolset, disabled?: ReadonlyArray<string> | null): boolean;

package/dist-lib/lib/tools/toolsets.js

@@ -9,6 +9,7 @@ export const TOOLSETS = [
 export function asToolset(value) {
     return TOOLSETS.find((toolset) => toolset === value) ?? null;
 }
+export const NETWORK_TOOLSETS = ['web-search', 'http-request', 'mcp-call'];
 export function permittedTools(tools, disabled) {
     if (!disabled?.length)
         return [...tools];

package/dist-lib/lib/tools/weather-lookup.js

@@ -63,7 +63,7 @@ export function createWeatherLookupTool({ fetch: fetchImpl, resolveHost = lookup
                 if (/location not found/i.test(body))
                     return { content: notFound(location) };
                 if (response.status !== 200) {
-                    return { error: unavailable(`it answered HTTP ${response.status}`) };
+                    return { error: unavailable(`it answered HTTP ${response.status}`), code: 'transport' };
                 }
                 let json;
                 try {
@@ -91,9 +91,15 @@ export function createWeatherLookupTool({ fetch: fetchImpl, resolveHost = lookup
                 if (ctx?.signal?.aborted)
                     return { error: 'weather_lookup cancelled' };
                 if (controller.signal.aborted) {
-                    return { error: `weather_lookup timed out after ${LOOKUP_TIMEOUT_MS} ms` };
+                    return {
+                        error: `weather_lookup timed out after ${LOOKUP_TIMEOUT_MS} ms`,
+                        code: 'timeout'
+                    };
                 }
-                return { error: unavailable(err instanceof Error ? err.message : String(err)) };
+                return {
+                    error: unavailable(err instanceof Error ? err.message : String(err)),
+                    code: 'transport'
+                };
             }
             finally {
                 clearTimeout(timeout);

package/dist-lib/lib/tools/web-fetch.js

@@ -28,7 +28,11 @@ export function createWebFetchTool({ fetch: fetchImpl, resolveHost = lookupHost
         toolset: 'web-search',
         description: 'Fetch a public web page and return its readable text. ' +
             'Use this to read the full content behind a web_search result URL, or a page the user ' +
-            'shares, when a search snippet is not enough to answer.',
+            'shares, when a search snippet is not enough to answer. ' +
+            'When the URL serves a file rather than a page — PDF, .docx, .xlsx, .pptx, an image, any ' +
+            'binary — this is also the tool that downloads it: the bytes become a chat attachment and ' +
+            'the result carries its attachmentId. It is the only way to get a remote file into the ' +
+            'chat; exec has no network and http_request truncates binary bodies.',
         parameters: {
             type: 'object',
             properties: {
@@ -79,7 +83,10 @@ export function createWebFetchTool({ fetch: fetchImpl, resolveHost = lookupHost
                     return { error: got.error };
                 const { response, finalUrl: currentUrl } = got;
                 if (response.status < 200 || response.status >= 300) {
-                    return { error: `HTTP ${response.status} fetching ${currentUrl.toString()}` };
+                    return {
+                        error: `HTTP ${response.status} fetching ${currentUrl.toString()}`,
+                        status: response.status
+                    };
                 }
                 const rawBody = await response.text();
                 const body = rawBody.length > MAX_HTML_CHARS ? rawBody.slice(0, MAX_HTML_CHARS) : rawBody;
@@ -140,9 +147,9 @@ export function createWebFetchTool({ fetch: fetchImpl, resolveHost = lookupHost
                     return { error: 'web_fetch cancelled' };
                 }
                 if (controller.signal.aborted) {
-                    return { error: `${url.hostname} timed out after ${PAGE_TIMEOUT_MS}ms` };
+                    return { error: `${url.hostname} timed out after ${PAGE_TIMEOUT_MS}ms`, code: 'timeout' };
                 }
-                return { error: err instanceof Error ? err.message : String(err) };
+                return { error: err instanceof Error ? err.message : String(err), code: 'transport' };
             }
             finally {
                 clearTimeout(timeout);
@@ -175,8 +182,14 @@ async function attachDocument(response, url, mimeType, attach) {
         raw: !mime.startsWith('image/')
     });
     return {
+        attachmentId: record.id,
+        fileName: record.fileName,
+        byteLength: record.byteLength,
         content: `Attached the file "${record.fileName}" (${Math.round(record.byteLength / 1024)}KB, ${mime}) from ${url.toString()} — ` +
-            'the user can open or save it. Its contents were NOT read: do not claim to know what is inside.'
+            'the user can open or save it. Its contents were NOT read, so do not describe what is inside ' +
+            'yet. To read it, stage it with exec as ' +
+            `inputs [{ "attachmentId": "${record.id}", "path": "${record.fileName}" }] — never ask the ` +
+            'user to attach a file this call already attached.'
     };
 }
 const MIME_EXTENSIONS = {

package/dist-lib/lib/tools/web-search.js

@@ -43,12 +43,15 @@ export function createWebSearchTool({ fetch } = {}) {
                 }
                 const failed = engineSummary.filter((e) => e.status !== 'ok').length;
                 if (engineSummary.length > 0 && failed === engineSummary.length) {
-                    return { error: `web_search unavailable: all ${failed} engines failed (timeout/error)` };
+                    return {
+                        error: `web_search unavailable: all ${failed} engines failed (timeout/error)`,
+                        code: 'transport'
+                    };
                 }
                 return { content: `No web results found for "${query}".` };
             }
             catch (err) {
-                return { error: err instanceof Error ? err.message : String(err) };
+                return { error: err instanceof Error ? err.message : String(err), code: 'transport' };
             }
         }
     };

package/dist-lib/schema/harness.js

@@ -23,7 +23,8 @@ export function registerHarnessTypes(ns) {
             { name: 'imageWidth', type: 'uint' },
             { name: 'imageHeight', type: 'uint' },
             { name: 'approvalMode', type: '@harness/approval-mode' },
-            { name: 'disabledToolsets', type: 'string', array: true }
+            { name: 'disabledToolsets', type: 'string', array: true },
+            { name: 'sandboxMode', type: 'bool' }
         ]
     });
     ns.register({
@@ -68,7 +69,8 @@ export function registerHarnessTypes(ns) {
             'fetch-result',
             'rag-result',
             'question-result',
-            'drive-result'
+            'drive-result',
+            'invoke'
         ],
         strings: true
     });
@@ -108,7 +110,9 @@ export function registerHarnessTypes(ns) {
             { name: 'grantedDrives', type: '@harness/granted-drive', array: true },
             { name: 'payload', type: 'json' },
             { name: 'grantedWriteDirs', type: 'string', array: true },
-            { name: 'captureInferenceCalls', type: 'bool' }
+            { name: 'captureInferenceCalls', type: 'bool' },
+            { name: 'capability', type: 'string' },
+            { name: 'arguments', type: 'json' }
         ]
     });
     ns.register({
@@ -458,6 +462,25 @@ export function registerHarnessTypes(ns) {
         name: 'transcribe-response',
         fields: [{ name: 'text', type: 'string', required: true }]
     });
+    ns.register({
+        name: 'detect-language-request',
+        fields: [
+            { name: 'text', type: 'string', required: true },
+            { name: 'topK', type: 'uint' }
+        ]
+    });
+    ns.register({
+        name: 'detected-language',
+        fields: [
+            { name: 'code', type: 'string', required: true },
+            { name: 'language', type: 'string', required: true },
+            { name: 'probability', type: 'float64' }
+        ]
+    });
+    ns.register({
+        name: 'detect-language-response',
+        fields: [{ name: 'languages', type: '@harness/detected-language', array: true, required: true }]
+    });
     ns.register({
         name: 'speak-request',
         fields: [
@@ -506,7 +529,8 @@ export function registerHarnessTypes(ns) {
             { name: 'steps', type: 'string', array: true },
             { name: 'configSteps', type: 'string', array: true },
             { name: 'fields', type: '@harness/skill-setup-field', array: true },
-            { name: 'satisfied', type: 'bool' }
+            { name: 'satisfied', type: 'bool' },
+            { name: 'oauth', type: '@harness/skill-oauth-config' }
         ]
     });
     ns.register({
@@ -613,6 +637,27 @@ export function registerHarnessTypes(ns) {
         name: 'kv-cache-delete-request',
         fields: [{ name: 'kvCacheKey', type: 'string', required: true }]
     });
+    ns.register({
+        name: 'skill-oauth-param',
+        fields: [
+            { name: 'key', type: 'string', required: true },
+            { name: 'value', type: 'string', required: true }
+        ]
+    });
+    ns.register({
+        name: 'skill-oauth-config',
+        fields: [
+            { name: 'stateKey', type: 'string', required: true },
+            { name: 'authUrl', type: 'string', required: true },
+            { name: 'tokenUrl', type: 'string', required: true },
+            { name: 'tokenAuth', type: 'string', required: true },
+            { name: 'scopes', type: 'string', array: true },
+            { name: 'extraAuthParams', type: '@harness/skill-oauth-param', array: true },
+            { name: 'registrationEndpoint', type: 'string' },
+            { name: 'port', type: 'uint' },
+            { name: 'sharedIosSession', type: 'bool' }
+        ]
+    });
 }
 export function registerHarnessApi(api) {
     api.register({
@@ -755,4 +800,9 @@ export function registerHarnessApi(api) {
         request: { name: '@harness/kv-cache-delete-request', stream: false },
         response: { name: '@harness/kv-cache-deletion-response', stream: false }
     });
+    api.register({
+        name: 'detect-language',
+        request: { name: '@harness/detect-language-request', stream: false },
+        response: { name: '@harness/detect-language-response', stream: false }
+    });
 }

package/dist-lib/spec/bind.js

@@ -124,4 +124,7 @@ export function bindApi(rpc, api) {
   if (api.deleteKvCache) {
     rpc.onDeleteKvCache((req) => api.deleteKvCache(req));
   }
+  if (api.detectLanguage) {
+    rpc.onDetectLanguage((req) => api.detectLanguage(req));
+  }
 }

package/dist-lib/spec/calls.js

@@ -38,5 +38,6 @@ export function harnessClient(rpc) {
     copySkillForEdit: (input) => rpc.copySkillForEdit(input),
     deleteOverlaySkill: (input) => rpc.deleteOverlaySkill(input),
     deleteKvCache: (input) => rpc.deleteKvCache(input),
+    detectLanguage: (input) => rpc.detectLanguage(input),
   };
 }

package/dist-lib/spec/hrpc/hrpc.json

@@ -364,6 +364,19 @@
         "stream": false
       },
       "version": 1
+    },
+    {
+      "id": 28,
+      "name": "@harness/detect-language",
+      "request": {
+        "name": "@harness/detect-language-request",
+        "stream": false
+      },
+      "response": {
+        "name": "@harness/detect-language-response",
+        "stream": false
+      },
+      "version": 1
     }
   ]
 }

package/dist-lib/spec/hrpc/index.js

@@ -61,7 +61,9 @@ const methods = new Map([
   ['@harness/delete-overlay-skill', 26],
   [26, '@harness/delete-overlay-skill'],
   ['@harness/delete-kv-cache', 27],
-  [27, '@harness/delete-kv-cache']
+  [27, '@harness/delete-kv-cache'],
+  ['@harness/detect-language', 28],
+  [28, '@harness/detect-language']
 ])
 
 class HRPC {
@@ -96,7 +98,8 @@ class HRPC {
       ['@harness/write-skill-file', getEncoding('@harness/write-skill-request')],
       ['@harness/copy-skill-for-edit', getEncoding('@harness/skill-name-request')],
       ['@harness/delete-overlay-skill', getEncoding('@harness/skill-name-request')],
-      ['@harness/delete-kv-cache', getEncoding('@harness/kv-cache-delete-request')]
+      ['@harness/delete-kv-cache', getEncoding('@harness/kv-cache-delete-request')],
+      ['@harness/detect-language', getEncoding('@harness/detect-language-request')]
     ])
     this._responseEncodings = new Map([
       ['@harness/completion', getEncoding('@harness/completion-event')],
@@ -126,7 +129,8 @@ class HRPC {
       ['@harness/write-skill-file', getEncoding('@harness/ok-response')],
       ['@harness/copy-skill-for-edit', getEncoding('@harness/copy-skill-response')],
       ['@harness/delete-overlay-skill', getEncoding('@harness/delete-skill-response')],
-      ['@harness/delete-kv-cache', getEncoding('@harness/kv-cache-deletion-response')]
+      ['@harness/delete-kv-cache', getEncoding('@harness/kv-cache-deletion-response')],
+      ['@harness/detect-language', getEncoding('@harness/detect-language-response')]
     ])
     this._rpc = new RPC(stream, async (req) => {
       const command = methods.get(req.command)
@@ -336,6 +340,10 @@ class HRPC {
     return this._call('@harness/delete-kv-cache', args)
   }
 
+  async detectLanguage(args) {
+    return this._call('@harness/detect-language', args)
+  }
+
   onCompletion(responseFn) {
     this._handlers['@harness/completion'] = responseFn
   }
@@ -448,6 +456,10 @@ class HRPC {
     this._handlers['@harness/delete-kv-cache'] = responseFn
   }
 
+  onDetectLanguage(responseFn) {
+    this._handlers['@harness/detect-language'] = responseFn
+  }
+
   _requestIsStream(command) {
     return [
       '@harness/completion',