@runlith/tagma 0.0.0-stage → 0.1.0

package/adapter/claudeHooks.d.ts

@@ -0,0 +1,10 @@
+/// <reference path="../types/node/index.d.ts" />
+/// <reference path="../host.d.ts" />
+import type { FileEffect, HarnessCall, HarnessPrinted, HookEvents, HookOccasion } from "@runlith/tagma/adapter/harness";
+import { type HookCodec } from "@runlith/tagma/adapter/hook";
+export declare const claudeCodec: HookCodec;
+export declare const CLAUDE_EVENTS: HookEvents;
+export declare const claudeSubject: (event: Record<string, unknown>) => HarnessCall | null;
+export declare const claudeFiles: (event: Record<string, unknown>) => readonly FileEffect[];
+export declare const claudePrinted: (event: Record<string, unknown>) => HarnessPrinted | null;
+export declare const claudeOccasion: HookOccasion;

package/adapter/claudeHooks.js

@@ -0,0 +1,4 @@
+// @bun
+var u=(o,e)=>({hooks:[{type:"command",command:o,...e===void 0?{}:{timeout:e}}]}),d=(o,e)=>JSON.stringify({hookSpecificOutput:{hookEventName:o,additionalContext:e}}),c=({allowed:o,words:e})=>JSON.stringify({decision:o?"approve":"deny",reason:e}),p=(o)=>(e)=>d(o,e),f=(o,e)=>(t,r)=>d(r==="before"?o:e,t);var w=(o)=>o===void 0?[]:[o];function n(o,e){let t=o[e];return typeof t==="string"&&t.trim().length>0?t.trim():null}function i(o,e){let t=o[e];return t!==null&&typeof t==="object"&&!Array.isArray(t)?t:{}}var _=(o)=>n(o,"session_id")??n(o,"sessionId"),S=()=>null,b=()=>null,R=()=>null,E=(o,e)=>e===null?null:n(o,e),C=()=>[],F=()=>null,h=[{mark:"*** Add File:",effect:"write"},{mark:"*** Update File:",effect:"write"},{mark:"*** Delete File:",effect:"delete"}],m="*** Move to:";function P(o){let e=[];for(let t of o.split(`
+`)){let r=h.find((l)=>t.startsWith(l.mark));if(r!==void 0){let l=t.slice(r.mark.length).trim();if(l.length>0)e.push({effect:r.effect,path:l});continue}if(!t.startsWith(m))continue;let s=t.slice(m.length).trim(),a=e[e.length-1];if(s.length===0)continue;if(a?.effect==="write")e[e.length-1]={effect:"move",path:s,from:a.path};else e.push({effect:"write",path:s})}return e}var g=(o)=>["askuserquestion","ask_user_question","request_user_input"].includes(o?.toLowerCase()??""),O=(o,e=!1)=>(t)=>{let r=e?[o,"--session-id"]:[o];for(let s=1;s<t.length;s+=1){let a=t[s];if(a!==void 0&&r.includes(a))return t[s+1]??null}return null},T=(o,e=[])=>{if(!("model"in o))return null;let t=n(o,"model");if(t===null)return{read:"absent"};return{read:"value",value:t,claim:e.includes(t)?"configured":"serving"}},U=(o)=>{let e=n(o,"tool_name")??n(o,"toolName");if(e===null)return null;let t=i(o,"tool_input"),r=n(t,"command")??n(t,"cmd")??n(t,"file_path")??n(t,"notebook_path")??n(t,"path")??n(t,"url")??n(t,"query")??n(t,"pattern")??n(o,"tool_input")??JSON.stringify(o.tool_input??{});return{id:n(o,"tool_use_id")??n(o,"toolUseId"),tool:e,subject:r}},y=(o,e)=>{let t=e[(n(o,"tool_name")??n(o,"toolName")??"").toLowerCase()];if(t===void 0)return null;let r=i(o,"tool_input"),s=t==="bash"?n(r,"command"):n(r,"file_path");return s===null?null:{id:n(o,"tool_use_id")??n(o,"toolUseId"),tool:t,subject:s}};var M={file:{keys:{},events:["hooks"],holes:!1,trust:null,entry:u},permission:c,context:(o)=>o,tool:f("PreToolUse","PostToolUse"),prompt:p("UserPromptSubmit")},L={sessionStart:"SessionStart",preWrite:"PreToolUse",postWrite:"PostToolUse",postRead:"PostToolUse",stop:"Stop",permission:"PermissionRequest",prompt:"UserPromptSubmit",sessionEnd:"SessionEnd",toolFailure:"PostToolUseFailure",stopFailure:"StopFailure",notification:"Notification"},x={bash:"bash",exec:"bash",edit:"edit",multiedit:"edit",write:"write",read:"read"},j=(o)=>y(o,x),D=(o)=>{let e=n(i(o,"tool_input"),"file_path");if(e===null)return[];let t=n(o,"tool_name")??n(o,"toolName");return[{effect:t!==null&&t.toLowerCase()!=="read"?"write":"read",path:e}]},k=(o,e)=>{let t=o.tool_response;if(typeof t==="string")return t;let r=i(o,"tool_response");return e.flatMap((s)=>typeof r[s]==="string"?[r[s]]:[]).join(`
+`)},V=(o)=>{let e=(n(o,"tool_name")??n(o,"toolName"))?.toLowerCase(),t=i(o,"tool_input");if(e==="bash"){let l=n(t,"command");return l===null?null:{_tag:"Shell",command:l,output:k(o,["stdout","stderr"])}}if(e!=="grep")return null;let r=i(o,"tool_response").filenames,s=n(t,"path");return{_tag:"Search",found:[...Array.isArray(r)?r.filter((l)=>typeof l==="string"):[],...s===null?[]:[s]],output:k(o,["content"])}},I=(o)=>{switch(o.name){case"SessionStart":return"session-start";case"UserPromptSubmit":return"turn-start";case"Stop":case"StopFailure":case"SessionEnd":return"turn-end";case"PermissionRequest":return"self-description";case"PreToolUse":return g(o.tool)?"wait":"activity";case"PostToolUse":case"PostToolUseFailure":return"activity";default:return"self-description"}};export{L as CLAUDE_EVENTS,M as claudeCodec,D as claudeFiles,I as claudeOccasion,V as claudePrinted,j as claudeSubject};

package/adapter/declaration.d.ts

@@ -0,0 +1,14 @@
+/// <reference path="../types/node/index.d.ts" />
+/// <reference path="../host.d.ts" />
+import type { AdapterHost, AdapterSettings, Provider } from "@runlith/tagma/adapter/provider";
+export type Declaration = {
+    readonly providers: readonly Provider[];
+    readonly settings: AdapterSettings | undefined;
+};
+export type SectionClaim = {
+    readonly title: string;
+    readonly default: string;
+    readonly modes: ReadonlyMap<string, string>;
+};
+export declare const claimSections: (claims: ReadonlyMap<string, SectionClaim>, providers: readonly Provider[], holder: string) => ReadonlyMap<string, SectionClaim>;
+export declare const declare: (models: unknown, host: AdapterHost, taken?: ReadonlyMap<string, string>, sections?: ReadonlyMap<string, SectionClaim>) => Declaration;

package/adapter/declaration.js

@@ -0,0 +1,2 @@
+// @bun
+import{Schema as c,SchemaGetter as P}from"effect";function A(e,r,n){if(r==="__proto__")Object.defineProperty(e,r,{value:n,enumerable:!0,writable:!0,configurable:!0});else e[r]=n}function T(e){return k(e,[])??null}function k(e,r){switch(typeof e){case"string":case"boolean":return e;case"number":return Number.isFinite(e)?e:null;case"bigint":return e.toString();case"object":return e===null?null:J(e,r);default:return}}function J(e,r){if(r.includes(e))return;r.push(e);let n=e.toJSON,i=typeof n==="function"?k(n.call(e),r):Array.isArray(e)?q(e,r):W(e,r);return r.pop(),i}function q(e,r){let n=null;for(let i=0;i<e.length;i+=1){let o=e[i],u=k(o,r)??null;if(n===null&&u!==o)n=e.slice(0,i);if(n!==null)n.push(u)}return n??e}function W(e,r){let n=Object.getPrototypeOf(e),i=n===Object.prototype||n===null,o=e instanceof Error?{...e,message:e.message}:e,u=Object.keys(o),p=i?null:{};for(let y=0;y<u.length;y+=1){let m=u[y],f=o[m],t=k(f,r);if(p===null&&(t!==f||t===void 0)){p={};for(let s of u.slice(0,y))A(p,s,o[s])}if(p!==null&&t!==void 0)A(p,m,t)}return p??e}var O=c.Unknown.pipe(c.encodeTo(c.Unknown,{encode:P.transform((e)=>T(e)),decode:P.passthrough()})),U=c.Record(c.String,O),ce=c.Record(c.String,U).annotate({identifier:"LLM.ProviderMetadata"}),pe=c.String,ye=c.String,ge=c.String.pipe(c.brand("LLM.ModelID")),fe=c.String.pipe(c.brand("LLM.ProviderID")),me=c.String,he=c.String,xe=c.String,E=["none","minimal","low","medium","high","xhigh","max"],Se=c.Literals(E),be=c.Literals(["low","medium","high"]),ke=c.Literals(["system","user","assistant","tool"]),Me=c.Literals(["stop","length","tool-calls","content-filter","error","unknown"]),we=c.Record(c.String,O);var L=new Set(["max"]);function R(e){let r=Object.entries(e.models).filter(([,o])=>o.operatorOnly===!0&&o.capabilities.includes("text"));if(r.length>0){let o=e.spawnTextModel;if(!o)return`Provider "${e.id}" has operator-only text model "${r[0]?.[0]}" but no spawnTextModel.`;let u=e.models[o];if(!u?.capabilities.includes("text"))return`Provider "${e.id}" spawnTextModel "${o}" is absent or not a text model.`;if(u.operatorOnly)return`Provider "${e.id}" spawnTextModel "${o}" is operator-only.`}let n=e.lightTextModel;if(n!==void 0){let o=e.models[n.model];if(!o?.capabilities.includes("text")||o.operatorOnly)return`Provider "${e.id}" lightTextModel "${n.model}" is absent, not a text model or operator-only.`;if(n.rung===null?o.reasoning.length>0:!o.reasoning.includes(n.rung))return`Provider "${e.id}" lightTextModel "${n.model}" offers no rung ${n.rung??"none"}.`}let i=Object.entries(e.models).find(([,o])=>o.capabilities.includes("text")&&!o.capacity);if(i!==void 0)return`Text model capacity is required for ${e.id}/${i[0]}.`;if(e.defaultTextModel===""&&!Object.values(e.models).some((o)=>o.capabilities.includes("text")))return null;if(!e.models[e.defaultTextModel]?.capabilities.includes("text"))return`Provider "${e.id}" defaultTextModel "${e.defaultTextModel}" is absent or not a text model.`;return null}function F(e){let r=new Map;for(let t of e){if(r.has(t.id))throw Error(`Provider "${t.id}" is registered twice.`);let s=R(t);if(s!==null)throw Error(s);r.set(t.id,t)}let n=e.flatMap((t)=>Object.entries(t.models).map(([s,l])=>({id:s,key:`${t.id}:${s}`,label:l.label,short:l.short??l.label,provider:t.id,providerLabel:t.label,capacity:l.capacity,cacheLifetime:t.cacheLifetime,requestLimits:t.requestLimits,capabilities:l.capabilities,toolChoice:l.toolChoice,reasoningOptions:l.reasoning.map((g)=>({id:g,label:z(g),short:B(g)})),defaultReasoning:l.defaultReasoning,switches:l.switches??[],supportsAdaptiveThinking:l.supportsAdaptiveThinking??!1,operatorOnly:l.operatorOnly??!1,compactionTrigger:l.compactionTrigger}))),i=(t)=>{let s=r.get(t);if(!s)throw Error(`Unknown model provider "${t}" \u2014 this catalog registers: ${e.map((l)=>l.id).join(", ")}.`);return s},o=(t)=>n.filter((s)=>s.capabilities.includes(t)),u=(t,s)=>o(s).filter((l)=>l.provider===t),p=(t,s)=>{let l=r.get(t);if(l===void 0)return;let g=s??l.defaultTextModel,b=u(l.id,"text");return b.find((w)=>w.id===g)??b.find((w)=>l.models[w.id]?.aliases?.includes(g))},y=(t,s)=>{let l=p(t,s);if(!l?.capacity){let g=i(t);throw Error(`Text model capacity is not configured for ${t}/${s??g.defaultTextModel}.`)}return l},m=(t,s)=>{let l=y(t,s);return l.operatorOnly?y(t,i(t).spawnTextModel):l},f=(t,s,l)=>{let g=Q(s,t);if(!g)return null;if(!L.has(g)||l&&!t.operatorOnly)return g;return t.reasoningOptions.filter((b)=>!L.has(b.id)).at(-1)?.id??null};return{providers:e,providerOptions:e.map((t)=>({id:t.id,label:t.label})),options:n,registered:(t)=>r.has(t),named:i,oauth:(t)=>i(t).auth==="oauth",providerLabel:(t)=>r.get(t)?.label??t,modelsOf:(t)=>n.filter((s)=>s.provider===t),modelsFor:u,modelsByCapability:o,defaultTextModelId:(t)=>i(t).defaultTextModel,findTextModel:p,resolveTextModel:y,spawnInherits:m,spawnReasoning:f,textModelCapacity:(t,s)=>{let l=y(t,s);if(!l.capacity)throw Error(`Text model capacity is not configured for ${l.key}.`);return l.capacity},namedSelection:(t,s)=>({provider:t,model:y(t,s).id}),supportsAdaptiveThinking:(t,s)=>y(t,s).supportsAdaptiveThinking,textModelIds:()=>{let t=[...new Set(o("text").map((s)=>s.id))];if(t.length===0)throw Error("Model catalog has no text models.");return t},reasoningLevelIds:()=>{let t=[...new Set(n.flatMap((s)=>s.reasoningOptions.map((l)=>l.id)))];if(t.length===0)throw Error("Model catalog has no reasoning levels.");return t}}}function Q(e,r){if(!r||r.reasoningOptions.length===0)return"";if(e&&r.reasoningOptions.some((n)=>n.id===e))return e;if(r.defaultReasoning&&r.reasoningOptions.some((n)=>n.id===r.defaultReasoning))return r.defaultReasoning;return r.reasoningOptions.find((n)=>n.id==="high")?.id??r.reasoningOptions[0]?.id??""}function z(e){switch(e){case"none":return"None";case"minimal":return"Minimal";case"low":return"Low";case"medium":return"Medium";case"high":return"High";case"xhigh":return"XHigh";case"max":return"Max";default:return e}}function B(e){switch(e){case"none":return"None";case"minimal":return"Min";case"low":return"Low";case"medium":return"Med";case"high":return"High";case"xhigh":return"XH";case"max":return"Max";default:return e}}import{Schema as v}from"effect";import{Schema as a}from"effect";var I=a.Struct({id:a.String,label:a.String}),x={id:a.String,label:a.String,hint:a.optional(a.String),required:a.optional(a.Literal(!0)),secret:a.optional(a.Literal(!0))},_=a.Union([a.Struct({...x,type:a.Literal("text"),placeholder:a.optional(a.String)}),a.Struct({...x,type:a.Literal("number"),min:a.optional(a.Number),unit:a.optional(a.String),placeholder:a.optional(a.String)}),a.Struct({...x,type:a.Literal("flag")}),a.Struct({...x,type:a.Literal("choice"),options:a.Array(I),default:a.optional(a.String)}),a.Struct({...x,type:a.Literal("set"),options:a.Array(I)})]),N=a.Union([_,a.Struct({...x,type:a.Literal("rows"),noun:a.String,fields:a.Array(_),discoverable:a.optional(a.Literal(!0))})]);import{Schema as d}from"effect";var X=200,G=160,V=d.String.check(d.isPattern(/^[a-z][a-z0-9-]*$/u),d.isMaxLength(64)),H=["tagma","lode"],Pe="tagma",Y=d.Literals(["configured","serving","last-recorded"]),Oe=d.Literals(["hook","vendor-record","transcript","session-store","terminal","protocol"]),Ee=d.Union([d.Struct({read:d.Literal("value"),value:d.String.check(d.isMaxLength(X)),claim:Y}),d.Struct({read:d.Literal("absent")}),d.Struct({read:d.Literal("unsupported")}),d.Struct({read:d.Literal("unreadable"),reason:d.String.check(d.isMaxLength(G))})]),Le=d.Struct({value:d.String,label:d.String,description:d.optional(d.String)}),Fe=d.Literals(["choice"]),Ie=d.Struct({id:d.NullOr(d.String.check(d.isMinLength(1))),tool:d.String.check(d.isMinLength(1)),subject:d.String.check(d.isMinLength(1))}),$e=["catalog","proxy"],Z=1e4,_e={chars:Z,basis:"unmeasured"},D="tagma";function Ne(e){let r=e[D];if(r===null)throw Error(`The harness cannot express permission stance ${D}.`);return r}function De(e,r){if(r===void 0)return[];let n=r.rung===null?r.model:`${r.model} at ${r.rung}`;if(e===null)throw Error(`The harness declares no model surface and cannot launch on ${n}.`);return e.argv(r)}var Ve={_tag:"char",char:"\x03"},je=()=>null,Ke=()=>null,Je=(e)=>(r,n)=>n.length===1?e(r,n[0]):null,qe=(e,r)=>{if(e.selected===null)return null;let n=e.options.findIndex((u)=>u.value===e.selected),i=e.options.findIndex((u)=>u.value===r);if(n<0||i<0)return null;let o=i>n?"down":"up";return[...Array.from({length:Math.abs(i-n)}).fill(o),"enter"]},We=(e,r)=>e.options.some((n)=>n.value===r)?[...r].map((n)=>({_tag:"char",char:n})):null,Ue=(e,r,n=e.findLastIndex((i)=>r(i)!==null))=>{if(n<0)return null;let i=[],o=[],u=n;for(;u>=0;u-=1){let p=r(e[u]);if(p===null)break;if(i.push({value:p.value,label:p.label}),p.selected)o.push(p.value)}return i.reverse(),{options:i,selected:o.length===1?o[0]:null,marked:o.length,above:u}},M={asksFrom:"never"},h={asksFrom:"review",timeout:"none"},Qe={names:"kind",byName:{bash:{kind:"execute",approval:h},read:{kind:"read",approval:M},ls:{kind:"read",approval:M},glob:{kind:"read",approval:M},grep:{kind:"read",approval:M},write:{kind:"write",approval:h},edit:{kind:"write",approval:h},delete:{kind:"write",approval:h},rename:{kind:"write",approval:h},webfetch:{kind:"network",approval:h},websearch:{kind:"network",approval:h}}};var ee=(e,r,n)=>{let i=new Map(e);for(let{accountMode:o}of r){if(o===void 0)continue;let u=i.get(o.section);i.set(o.section,{title:u?.title??o.title,default:u?.default??o.default,modes:new Map([...u?.modes??[],[o.id,n]])})}return i},ne=(e,r)=>{let n=r.accountMode,i=n===void 0?void 0:e.get(n.section);if(n===void 0||i===void 0)return null;let o=i.modes.get(n.id);if(o!==void 0)return`provider "${r.id}" declares mode "${n.id}" of section "${n.section}", already declared by ${o}`;if(i.title!==n.title||i.default!==n.default)return`provider "${r.id}" declares section "${n.section}" with another title or default mode than its other modes`;return null},C=(e)=>typeof e?.program!=="string"||!Array.isArray(e.args)||e.args.some((r)=>typeof r!=="string"),re=(e)=>typeof e.directory!=="string"||e.directory===""||C(e.login)||C(e.status)||typeof e.loggedIn!=="function"||e.renew!==void 0&&C(e.renew),j=(e)=>{if(e===void 0||e.credential==null||typeof e.key!=="function"||typeof e.label!=="function")return!0;if(!Array.isArray(e.signIns)||e.signIns.length===0)return!0;let r=new Set;for(let n of e.signIns){if(r.has(n.kind))return!0;switch(r.add(n.kind),n.kind){case"loopback":if(typeof n.run!=="function")return!0;break;case"device":if(n.vendor==null||typeof n.store!=="function")return!0;break;case"paste":if(typeof n.begin!=="function")return!0;break;case"key":if(typeof n.store!=="function")return!0;break;default:return!0}}return!1},te=v.is(V),oe=(e)=>{let{terminal:r,acp:n}=e;if(!te(e.id)||H.includes(e.id))return`harness provider "${e.id}" needs an id of up to 64 lowercase letters, digits and hyphens that starts with a letter and is none of ${H.join(", ")}`;if(r!==void 0&&(!S(r.binary)||!S(r.prefix)||typeof r.launch?.interactive!=="function"||typeof r.launch.resume!=="function"||typeof r.launch.root!=="function"))return`harness provider "${e.id}" declares a terminal surface without its binary, session prefix or launch`;if(n!==void 0&&(typeof n.argv!=="function"||typeof n.configure!=="function"))return`harness provider "${e.id}" declares an ACP surface without its argv or configure`;if(r!==void 0&&n!==void 0&&n.hosts===null&&n.argv(void 0)[0]!==r.binary)return`harness provider "${e.id}" launches its ACP agent with a program other than its terminal binary ${r.binary}`;if(r===void 0&&n!==void 0&&n.hosts!==null&&!S(n.program))return`harness provider "${e.id}" hosts its ACP agent without a terminal surface and names no program its runner drives`;return null};function ie(e){if(typeof e.id!=="string"||e.id==="")return"a provider declares no id";if(e.catalog!==void 0&&typeof e.catalog.read!=="function")return`provider "${e.id}" declares a malformed catalog reader`;if(e.dynamicCatalog===!0&&e.catalog===void 0)return`provider "${e.id}" declares a dynamic catalog without its reader`;let{id:r,accountMode:n}=e;if(n!==void 0&&[n.section,n.title,n.default,n.id,n.label,n.hint].some((i)=>typeof i!=="string"||i===""))return`provider "${e.id}" declares a malformed account mode`;if(n!==void 0&&e.accounts===void 0)return`provider "${e.id}" declares an account mode without accounts`;if(e.kind==="wire"){if(typeof e.profile?.model!=="function")return`provider "${e.id}" declares no request profile`;if(typeof e.quota?.read!=="function")return`provider "${e.id}" declares no quota`;if(e.auth==="cli")return`wire provider "${e.id}" signs in through a CLI`;if(e.auth==="oauth"&&j(e.accounts))return`provider "${e.id}" declares no subscription accounts`;if(Object.keys(e.imageModels??{}).length>0&&typeof e.images?.generate!=="function")return`provider "${e.id}" declares image models without an image profile`;return null}if(e.kind==="harness"){if(e.imageModels!==void 0)return`harness provider "${e.id}" declares image models`;let i=oe(e);if(i!==null)return i;if(typeof e.environment!=="function")return`provider "${e.id}" declares no account environment`;if(e.auth==="api-key")return j(e.accounts)?`provider "${e.id}" declares malformed key accounts`:null;if(e.accounts!==void 0&&re(e.accounts))return`provider "${e.id}" declares malformed accounts`;return e.auth==="cli"?null:`harness provider "${r}" declares no supported sign-in`}return`provider "${String(e.id)}" is neither a wire nor a harness provider`}var ae=v.is(v.Array(N)),S=(e)=>typeof e==="string"&&e!=="",K=(e)=>(e.type==="choice"||e.type==="set")&&e.options.length===0||e.type==="rows"&&(e.fields.length===0||e.fields.some(K)),se=(e)=>{if(e===void 0)return null;if(!S(e.title)||!S(e.instance)||!S(e.name))return"the adapter declares settings without a title, an instance name or a naming field";if(!ae(e.fields))return"the adapter declares settings fields the Providers screen cannot draw";if(new Set(e.fields.map((r)=>r.id)).size!==e.fields.length||e.fields.some(K))return"the adapter declares settings fields with repeated ids, or choices without options";if(e.fields.some((r)=>r.type==="rows"&&r.fields.some((n)=>n.id==="_source"||n.id==="_key")))return"row fields use reserved form metadata names";if(!e.fields.some((r)=>r.id===e.name&&r.type==="text"))return"the adapter declares settings without a text field that names an instance";if(e.validate!==void 0&&typeof e.validate!=="function"||e.discover!==void 0&&typeof e.discover!=="function")return"the adapter declares settings whose validate or discover is not a function";return null},Ze=(e,r,n=new Map,i=new Map)=>{if(typeof e!=="function")throw Error("models is not an adapter: make it with defineAdapter");let o=e,u=se(o.settings);if(u!==null)throw Error(u);let p=o(r);if(!Array.isArray(p))throw Error("the adapter does not answer a list of providers");let y=p.map((t)=>t.catalog===void 0?t:{...t,dynamicCatalog:!0}),m=new Set,f=i;for(let t of y){let s=ie(t)??R(t)??ne(f,t);if(s!==null)throw Error(s);let l=n.get(t.id)??(m.has(t.id)?"this adapter":void 0);if(l!==void 0)throw Error(`provider "${t.id}" is already declared by adapter ${l}`);m.add(t.id),f=ee(f,[t],"this adapter")}return F(y),{providers:y,settings:o.settings}};export{ee as claimSections,Ze as declare};

package/adapter/harness.d.ts

@@ -0,0 +1,454 @@
+/// <reference path="../types/node/index.d.ts" />
+/// <reference path="../host.d.ts" />
+import { Schema, type Effect, type FileSystem, type PlatformError } from "effect";
+import type { Approval, PermissionKind } from "@runlith/tagma/internal/packages/agent/src/permissions/vocabulary";
+import type { TransportFailure } from "@runlith/tagma/internal/packages/agent/src/transcript/entries";
+import type { TransportCapabilities, TransportWeb } from "@runlith/tagma/internal/packages/agent/src/thread/record";
+import type { ModelSwitches } from "@runlith/llm/models/description";
+import type { HookCodec } from "@runlith/tagma/adapter/hook";
+import type { MetadataReader } from "@runlith/tagma/adapter/metadata";
+export declare const HARNESS_ID_MAX = 200;
+export declare const HARNESS_DETAIL_MAX = 160;
+export declare const harnessNameSchema: Schema.String;
+export declare const RESERVED_HARNESS_NAMES: readonly string[];
+export declare const HOST_COMMAND = "tagma";
+export declare const harnessClaimSchema: Schema.Literals<readonly [
+    "configured",
+    "serving",
+    "last-recorded"
+]>;
+export type HarnessClaim = typeof harnessClaimSchema.Type;
+export declare const harnessProvenanceSchema: Schema.Literals<readonly [
+    "hook",
+    "vendor-record",
+    "transcript",
+    "session-store",
+    "terminal",
+    "protocol"
+]>;
+export type HarnessProvenance = typeof harnessProvenanceSchema.Type;
+export declare const harnessModelReportSchema: Schema.Union<readonly [
+    Schema.Struct<{
+        readonly read: Schema.Literal<"value">;
+        readonly value: Schema.String;
+        readonly claim: Schema.Literals<readonly [
+            "configured",
+            "serving",
+            "last-recorded"
+        ]>;
+    }>,
+    Schema.Struct<{
+        readonly read: Schema.Literal<"absent">;
+    }>,
+    Schema.Struct<{
+        readonly read: Schema.Literal<"unsupported">;
+    }>,
+    Schema.Struct<{
+        readonly read: Schema.Literal<"unreadable">;
+        readonly reason: Schema.String;
+    }>
+]>;
+export type HarnessModelReport = typeof harnessModelReportSchema.Type;
+export declare const harnessQuestionOptionSchema: Schema.Struct<{
+    readonly value: Schema.String;
+    readonly label: Schema.String;
+    readonly description: Schema.optional<Schema.String>;
+}>;
+export type HarnessQuestionOption = typeof harnessQuestionOptionSchema.Type;
+export declare const harnessQuestionKindSchema: Schema.Literals<readonly [
+    "choice"
+]>;
+export type HarnessQuestionKind = typeof harnessQuestionKindSchema.Type;
+export declare const harnessCallSchema: Schema.Struct<{
+    readonly id: Schema.NullOr<Schema.String>;
+    readonly tool: Schema.String;
+    readonly subject: Schema.String;
+}>;
+export type HarnessCall = typeof harnessCallSchema.Type;
+export declare const MCP_TOOL_SHAPES: readonly [
+    "catalog",
+    "proxy"
+];
+export type McpToolShape = (typeof MCP_TOOL_SHAPES)[number];
+export type HookEvents = {
+    readonly sessionStart: string | null;
+    readonly preWrite: string | null;
+    readonly postWrite: string | null;
+    readonly postRead: string | null;
+    readonly stop: string | null;
+    readonly permission: string | null;
+    readonly agentResponse?: string;
+    readonly prompt?: string;
+    readonly sessionEnd?: string;
+    readonly toolFailure?: string;
+    readonly stopFailure?: string;
+    readonly notification?: string;
+};
+export type HookUserFile = {
+    readonly folder: readonly string[];
+    readonly file: string;
+    readonly homeEnv?: string;
+};
+export type HookAsset = {
+    readonly file: string;
+    readonly content: string;
+};
+export type HookContextLimit = {
+    readonly chars: number;
+    readonly basis: 'measured' | 'reported' | 'unmeasured';
+};
+export declare const HOOK_CONTEXT_CHARS = 10000;
+export declare const UNMEASURED_HOOK_CONTEXT: HookContextLimit;
+export type HookSurface = {
+    readonly file: string;
+    readonly assets?: readonly HookAsset[];
+    readonly codec: HookCodec;
+    readonly events: HookEvents;
+    readonly user: HookUserFile | null;
+    readonly context: HookContextLimit;
+    readonly promptContext?: boolean;
+};
+export type McpConfigFile = {
+    readonly _tag: 'Project';
+    readonly path: string;
+} | {
+    readonly _tag: 'Home';
+    readonly folder: readonly string[];
+    readonly file: string;
+    readonly homeEnv?: string;
+};
+export type McpSurface = {
+    readonly file: McpConfigFile;
+    readonly format: 'json' | 'toml';
+    readonly servers: string | readonly string[];
+    readonly environment?: string;
+    readonly declaration?: (cli: readonly string[], environment: Readonly<Record<string, string>>) => Readonly<Record<string, unknown>>;
+    readonly fields?: Readonly<Record<string, string | boolean | number>>;
+    readonly approve?: (name: string) => readonly string[];
+};
+export type HarnessPrinted = {
+    readonly _tag: 'Shell';
+    readonly command: string;
+    readonly output: string;
+} | {
+    readonly _tag: 'Search';
+    readonly found: readonly string[];
+    readonly output: string;
+};
+export type FileEffect = {
+    readonly effect: 'read';
+    readonly path: string;
+} | {
+    readonly effect: 'write';
+    readonly path: string;
+} | {
+    readonly effect: 'delete';
+    readonly path: string;
+} | {
+    readonly effect: 'move';
+    readonly path: string;
+    readonly from: string;
+};
+export type HookOccasion = (event: {
+    readonly name: string;
+    readonly tool?: string;
+    readonly notification?: string;
+}) => 'session-start' | 'turn-start' | 'activity' | 'wait' | 'turn-end' | 'self-description';
+export type RpcRequest = {
+    readonly method: string;
+    readonly params: unknown;
+};
+export type PrepareAnswer = {
+    readonly _tag: 'Answered';
+    readonly value: unknown;
+} | {
+    readonly _tag: 'VendorError';
+    readonly code: number;
+    readonly message: string;
+};
+export type PrepareJudgment<T> = {
+    readonly _tag: 'Accept';
+    readonly value: T;
+} | {
+    readonly _tag: 'Refuse';
+    readonly reason: string;
+};
+export type PreparedRoot = {
+    readonly id: string;
+    readonly artifact: string;
+};
+export type HarnessPrepare = {
+    readonly server: (cwd: string) => {
+        readonly program: string;
+        readonly args: ReadonlyArray<string>;
+    };
+    readonly initialize: {
+        readonly request: (client: {
+            readonly name: string;
+            readonly version: string;
+        }) => RpcRequest;
+        readonly judge: (outcome: PrepareAnswer) => PrepareJudgment<void>;
+    };
+    readonly start: {
+        readonly request: (workspace: string) => RpcRequest;
+        readonly judge: (outcome: PrepareAnswer) => PrepareJudgment<PreparedRoot>;
+    };
+    readonly read: {
+        readonly request: (threadId: string) => RpcRequest;
+        readonly judge: (outcome: PrepareAnswer) => PrepareJudgment<void>;
+    };
+};
+export declare const ADOPTED_HARNESS_PERMISSION_STANCE: "tagma";
+export type HarnessCutAsk = {
+    readonly root: string;
+    readonly address: string | null;
+};
+export type HarnessCutRows = 'copied' | 'unaddressed';
+export type HarnessCutTurns = {
+    readonly request: (root: string) => RpcRequest;
+    readonly judge: (outcome: PrepareAnswer) => PrepareJudgment<readonly (string | null)[]>;
+};
+export type HarnessCutMaking = {
+    readonly _tag: 'Launch';
+    readonly argv: (ask: HarnessCutAsk, into: string, prompt?: string, choice?: HarnessModelChoice, permission?: readonly string[]) => string[];
+    readonly rows: HarnessCutRows;
+} | {
+    readonly _tag: 'Prepare';
+    readonly server: (cwd: string) => {
+        readonly program: string;
+        readonly args: ReadonlyArray<string>;
+    };
+    readonly initialize: HarnessPrepare['initialize'];
+    readonly fork: {
+        readonly request: (ask: HarnessCutAsk, workspace: string) => RpcRequest;
+        readonly judge: (outcome: PrepareAnswer) => PrepareJudgment<PreparedRoot>;
+    };
+    readonly rows: HarnessCutRows | HarnessCutTurns;
+};
+export type HarnessCut = {
+    readonly whole: HarnessCutMaking | null;
+    readonly point: HarnessCutMaking | null;
+};
+export type HarnessCarry = {
+    readonly folder: string;
+    readonly session: (files: FileSystem.FileSystem, home: string, root: string) => Effect.Effect<readonly string[], PlatformError.PlatformError>;
+};
+export type HarnessRunSeen = {
+    readonly turn: string | null;
+    readonly before: string | null;
+};
+export type HarnessAddress = {
+    readonly reads: 'turn' | 'transcript';
+    readonly of: (seen: HarnessRunSeen) => string | null;
+};
+export type HarnessPermissionStance = typeof ADOPTED_HARNESS_PERMISSION_STANCE;
+export type HarnessPermissionArgv = Readonly<Record<HarnessPermissionStance, readonly string[] | null>>;
+export declare function adoptedPermissionArgv(declaration: HarnessPermissionArgv): readonly string[];
+export type HarnessPermissionModes = {
+    readonly values: readonly string[];
+    readonly argv: (mode: string) => readonly string[];
+};
+export type HarnessModelChoice = {
+    readonly model: string;
+    readonly rung: string | null;
+};
+export type HarnessModelArgv = {
+    readonly provider: string;
+    readonly argv: (choice: HarnessModelChoice) => readonly string[];
+} | null;
+export declare function chosenModelArgv(declaration: HarnessModelArgv, choice: HarnessModelChoice | undefined): readonly string[];
+export type HarnessLaunch = {
+    readonly permission: HarnessPermissionArgv;
+    readonly permissionModes?: HarnessPermissionModes;
+    readonly model: HarnessModelArgv;
+    readonly interactive: (prompt?: string, choice?: HarnessModelChoice, permission?: readonly string[]) => string[];
+    readonly resume: (key: string, prompt?: string, choice?: HarnessModelChoice, permission?: readonly string[]) => string[];
+    readonly assign?: (key: string, prompt?: string, choice?: HarnessModelChoice, permission?: readonly string[]) => string[];
+    readonly root: (argv: readonly string[]) => string | null;
+    readonly export?: (argv: readonly string[], path: string) => string[];
+    readonly witness?: (text: string) => string | null;
+    readonly prepare?: HarnessPrepare;
+    readonly cut?: HarnessCut;
+    readonly carry?: HarnessCarry;
+    readonly address?: HarnessAddress;
+};
+export type ScreenAskPicks = {
+    readonly checked: readonly string[];
+};
+export type ScreenAskTyped = {
+    readonly value: string;
+    readonly draft: string;
+};
+export type ScreenAsk = {
+    readonly kind: HarnessQuestionKind;
+    readonly prompt: string;
+    readonly header: string | null;
+    readonly subject: string | null;
+    readonly options: readonly HarnessQuestionOption[];
+    readonly selected: string | null;
+    readonly freeform?: ScreenAskTyped;
+    readonly picks?: ScreenAskPicks;
+};
+export type HarnessWidgetKey = 'up' | 'down' | 'enter' | 'esc' | {
+    readonly _tag: 'char';
+    readonly char: string;
+} | {
+    readonly _tag: 'text';
+    readonly text: string;
+};
+export type HarnessScreenReader = (lines: readonly string[]) => ScreenAsk | null;
+export type HarnessQuit = readonly (readonly HarnessWidgetKey[])[];
+export declare const INTERRUPT_KEY: HarnessWidgetKey;
+export declare const unmeasuredScreen: HarnessScreenReader;
+export declare const unmeasuredKeys: () => null;
+export declare const oneValue: (keys: (ask: ScreenAsk, value: string) => readonly HarnessWidgetKey[] | null) => (ask: ScreenAsk, values: readonly string[]) => readonly HarnessWidgetKey[] | null;
+export declare const navigateChoice: (ask: ScreenAsk, value: string) => readonly HarnessWidgetKey[] | null;
+export declare const typeChoice: (ask: ScreenAsk, value: string) => readonly HarnessWidgetKey[] | null;
+export type ScreenChoice = {
+    readonly value: string;
+    readonly label: string;
+    readonly selected: boolean;
+};
+export type ScreenChoices = {
+    readonly options: readonly HarnessQuestionOption[];
+    readonly selected: string | null;
+    readonly marked: number;
+    readonly above: number;
+};
+export declare const screenChoices: (lines: readonly string[], match: (line: string) => ScreenChoice | null, end?: number) => ScreenChoices | null;
+export type HarnessReturned = {
+    readonly clear: readonly HarnessWidgetKey[];
+    readonly counts: 'breaks' | 'lines';
+};
+export type HarnessComposer = {
+    readonly of: (lines: readonly string[]) => string | null;
+    readonly returns?: HarnessReturned;
+    readonly drafted?: readonly HarnessWidgetKey[];
+};
+export type HarnessExitArm = {
+    readonly key: HarnessWidgetKey;
+    readonly windowMs: number;
+    readonly banner: string;
+    readonly version: string;
+};
+export type HarnessEnds = {
+    readonly interrupt: 'screen' | 'record';
+    readonly idle: 'notification' | null;
+    readonly tail: 'final' | 'prompt';
+};
+export type HarnessSetup = {
+    readonly file: string;
+    readonly done: string;
+};
+export type InstructionSurface = {
+    readonly file: string;
+    readonly imports?: (text: string) => boolean;
+};
+export type SkillSurface = {
+    readonly project?: string;
+    readonly user: HookUserFile;
+};
+export type HarnessTool = {
+    readonly kind: PermissionKind;
+    readonly approval: Approval;
+};
+export type HarnessTools = {
+    readonly names: 'vendor' | 'kind';
+    readonly byName: Readonly<Record<string, HarnessTool>>;
+};
+export declare const ASKS_NEVER: Approval;
+export declare const ASKS_IN_REVIEW: Approval;
+export declare const LEGACY_TOOLS: HarnessTools;
+export type TerminalSurface = {
+    readonly prefix: string;
+    readonly variable?: string;
+    readonly exports?: readonly string[];
+    readonly binary: string;
+    readonly installedIn?: (home: string) => readonly string[];
+    readonly install?: string;
+    readonly metadata?: MetadataReader;
+    readonly tools: HarnessTools;
+    readonly env?: Record<string, string>;
+    readonly hooks: HookSurface | null;
+    readonly setup?: HarnessSetup;
+    readonly instructions?: InstructionSurface;
+    readonly skill?: SkillSurface;
+    readonly mcpTools: McpToolShape;
+    readonly mcpCallMeta?: string;
+    readonly mcp: McpSurface | null;
+    readonly occasionOf: HookOccasion;
+    readonly sessionKeyOf: (event: Record<string, unknown>) => string | null;
+    readonly modelOf: (event: Record<string, unknown>) => HarnessModelReport | null;
+    readonly reportsModel: boolean;
+    readonly turnOf: (event: Record<string, unknown>) => string | null;
+    readonly answerKey: string | null;
+    readonly promptKey?: string;
+    readonly subjectOf: (event: Record<string, unknown>) => HarnessCall | null;
+    readonly filesOf: (event: Record<string, unknown>) => readonly FileEffect[];
+    readonly printedOf: (event: Record<string, unknown>) => HarnessPrinted | null;
+    readonly failureOf?: (event: Record<string, unknown>) => TransportFailure | null;
+    readonly eventKeys: readonly string[];
+    readonly screenAskOf: HarnessScreenReader;
+    readonly promptScreenOf?: (lines: readonly string[]) => boolean;
+    readonly composer?: HarnessComposer;
+    readonly keysOf: (ask: ScreenAsk, values: readonly string[]) => readonly HarnessWidgetKey[] | null;
+    readonly cancelKeysOf: (ask: ScreenAsk) => readonly HarnessWidgetKey[] | null;
+    readonly interrupt: readonly HarnessWidgetKey[] | null;
+    readonly exitArm?: HarnessExitArm;
+    readonly steer: 'step' | 'none';
+    readonly quit: HarnessQuit | null;
+    readonly callEnvelopeMs: number | null;
+    readonly ends: HarnessEnds;
+    readonly launch: HarnessLaunch;
+};
+export type ConfigChoice = {
+    readonly configId: string;
+    readonly value: string;
+};
+export type AcpProves = {
+    readonly law: NonNullable<TransportCapabilities['law']>;
+    readonly touch: NonNullable<TransportCapabilities['touch']>;
+    readonly authorship: NonNullable<TransportCapabilities['authorship']>;
+    readonly fork: boolean;
+    readonly rewind: boolean;
+    readonly compaction: boolean | 'foreign' | 'vendor';
+    readonly continue: boolean;
+    readonly usage: TransportCapabilities['usage'];
+    readonly aside: Exclude<TransportCapabilities['aside'], 'request'>;
+};
+export type AcpProfile = {
+    readonly argv: (choice: HarnessModelChoice | undefined) => readonly string[];
+    readonly untitled?: readonly string[];
+    readonly titles: boolean;
+    readonly configure: (choice: HarnessModelChoice | undefined, switches: ModelSwitches) => readonly ConfigChoice[];
+    readonly reportedModel: string | null;
+    readonly hosts: string | null;
+    readonly serves: string | null;
+    readonly program?: string;
+    readonly web: TransportWeb;
+    readonly mode: string;
+    readonly proves: AcpProves;
+    readonly toolCatalog?: TransportCapabilities['toolCatalog'];
+    readonly storage?: {
+        readonly environment: string;
+        readonly folder: string;
+    };
+    readonly graceMs: number;
+    readonly callEnvelopeMs: number | null;
+    readonly handshakeMs: number;
+    readonly login: {
+        readonly command: string;
+        readonly codes: readonly number[];
+    };
+    readonly lockedCode: number | null;
+    readonly otherMutates: boolean;
+    readonly midTurn: 'after-turn' | 'steer';
+    readonly sharedSessions: boolean;
+    readonly extensions: readonly string[];
+};
+export type HarnessSurfaces = {
+    readonly harnessLabel?: string;
+    readonly mark?: string;
+    readonly terminal?: TerminalSurface;
+    readonly acp?: AcpProfile;
+};

package/adapter/harness.js

@@ -0,0 +1,2 @@
+// @bun
+import{Schema as e}from"effect";var p=200,c=160,h=e.String.check(e.isPattern(/^[a-z][a-z0-9-]*$/u),e.isMaxLength(64)),f=["tagma","lode"],H="tagma",g=e.Literals(["configured","serving","last-recorded"]),x=e.Literals(["hook","vendor-record","transcript","session-store","terminal","protocol"]),S=e.Union([e.Struct({read:e.Literal("value"),value:e.String.check(e.isMaxLength(p)),claim:g}),e.Struct({read:e.Literal("absent")}),e.Struct({read:e.Literal("unsupported")}),e.Struct({read:e.Literal("unreadable"),reason:e.String.check(e.isMaxLength(c))})]),k=e.Struct({value:e.String,label:e.String,description:e.optional(e.String)}),v=e.Literals(["choice"]),C=e.Struct({id:e.NullOr(e.String.check(e.isMinLength(1))),tool:e.String.check(e.isMinLength(1)),subject:e.String.check(e.isMinLength(1))}),A=["catalog","proxy"],u=1e4,R={chars:u,basis:"unmeasured"},y="tagma";function b(n){let r=n[y];if(r===null)throw Error(`The harness cannot express permission stance ${y}.`);return r}function M(n,r){if(r===void 0)return[];let o=r.rung===null?r.model:`${r.model} at ${r.rung}`;if(n===null)throw Error(`The harness declares no model surface and cannot launch on ${o}.`);return n.argv(r)}var w={_tag:"char",char:"\x03"},P=()=>null,E=()=>null,T=(n)=>(r,o)=>o.length===1?n(r,o[0]):null,_=(n,r)=>{if(n.selected===null)return null;let o=n.options.findIndex((t)=>t.value===n.selected),a=n.options.findIndex((t)=>t.value===r);if(o<0||a<0)return null;let l=a>o?"down":"up";return[...Array.from({length:Math.abs(a-o)}).fill(l),"enter"]},O=(n,r)=>n.options.some((o)=>o.value===r)?[...r].map((o)=>({_tag:"char",char:o})):null,K=(n,r,o=n.findLastIndex((a)=>r(a)!==null))=>{if(o<0)return null;let a=[],l=[],t=o;for(;t>=0;t-=1){let d=r(n[t]);if(d===null)break;if(a.push({value:d.value,label:d.label}),d.selected)l.push(d.value)}return a.reverse(),{options:a,selected:l.length===1?l[0]:null,marked:l.length,above:t}},i={asksFrom:"never"},s={asksFrom:"review",timeout:"none"},N={names:"kind",byName:{bash:{kind:"execute",approval:s},read:{kind:"read",approval:i},ls:{kind:"read",approval:i},glob:{kind:"read",approval:i},grep:{kind:"read",approval:i},write:{kind:"write",approval:s},edit:{kind:"write",approval:s},delete:{kind:"write",approval:s},rename:{kind:"write",approval:s},webfetch:{kind:"network",approval:s},websearch:{kind:"network",approval:s}}};export{y as ADOPTED_HARNESS_PERMISSION_STANCE,s as ASKS_IN_REVIEW,i as ASKS_NEVER,c as HARNESS_DETAIL_MAX,p as HARNESS_ID_MAX,u as HOOK_CONTEXT_CHARS,H as HOST_COMMAND,w as INTERRUPT_KEY,N as LEGACY_TOOLS,A as MCP_TOOL_SHAPES,f as RESERVED_HARNESS_NAMES,R as UNMEASURED_HOOK_CONTEXT,b as adoptedPermissionArgv,M as chosenModelArgv,C as harnessCallSchema,g as harnessClaimSchema,S as harnessModelReportSchema,h as harnessNameSchema,x as harnessProvenanceSchema,v as harnessQuestionKindSchema,k as harnessQuestionOptionSchema,_ as navigateChoice,T as oneValue,K as screenChoices,O as typeChoice,E as unmeasuredKeys,P as unmeasuredScreen};

package/adapter/hook.d.ts

@@ -0,0 +1,43 @@
+/// <reference path="../types/node/index.d.ts" />
+/// <reference path="../host.d.ts" />
+export type HookVerdict = {
+    readonly allowed: boolean;
+    readonly words: string;
+};
+export type HookMoment = 'before' | 'after';
+export type HookTrust = {
+    readonly home: string;
+    readonly folder: string;
+    readonly file: string;
+    readonly table: string;
+    readonly key: (filePath: string, event: string, group: number, handler: number) => string;
+};
+export type HookCommand = {
+    readonly command: string;
+    readonly timeout?: number;
+};
+export type HookHandler = HookCommand & {
+    readonly type: 'command';
+};
+export type HookEntry = HookCommand | {
+    readonly hooks: readonly HookHandler[];
+};
+export type HookFileShape = {
+    readonly keys: Readonly<Record<string, unknown>>;
+    readonly events: readonly string[];
+    readonly holes: boolean;
+    readonly trust: HookTrust | null;
+    readonly entry: (command: string, timeout: number | undefined) => HookEntry;
+};
+export declare const commandGroup: (command: string, timeout: number | undefined) => HookEntry;
+export declare const specificOutput: (hookEventName: string, additionalContext: string) => string;
+export declare const approvePermission: ({ allowed, words }: HookVerdict) => string;
+export declare const eventOutput: (event: string) => (text: string) => string;
+export declare const toolOutput: (before: string, after: string) => (text: string, moment: HookMoment) => string;
+export type HookCodec = {
+    readonly file: HookFileShape;
+    readonly permission: (verdict: HookVerdict) => string;
+    readonly context: (text: string) => string;
+    readonly tool: (text: string, moment: HookMoment) => string;
+    readonly prompt: ((text: string) => string) | null;
+};

package/adapter/hook.js

@@ -0,0 +1,2 @@
+// @bun
+var i=(e,o)=>({hooks:[{type:"command",command:e,...o===void 0?{}:{timeout:o}}]}),n=(e,o)=>JSON.stringify({hookSpecificOutput:{hookEventName:e,additionalContext:o}}),s=({allowed:e,words:o})=>JSON.stringify({decision:e?"approve":"deny",reason:o}),d=(e)=>(o)=>n(e,o),a=(e,o)=>(t,r)=>n(r==="before"?e:o,t);export{s as approvePermission,i as commandGroup,d as eventOutput,n as specificOutput,a as toolOutput};

package/adapter/hostModules.d.ts

@@ -0,0 +1,19 @@
+/// <reference path="../types/node/index.d.ts" />
+/// <reference path="../host.d.ts" />
+import { Schema } from "effect";
+export declare const tagmaSection: Schema.Struct<{
+    readonly host: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly build: Schema.optional<Schema.Literal<"developer">>;
+    readonly labels: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
+}>;
+export declare const hostSpecifiers: (manifests: readonly string[]) => readonly string[];
+export type DeveloperMark = {
+    readonly manifest: string;
+} | null;
+export declare const developerMarks: () => ((path: string) => Promise<DeveloperMark>);
+export type DeclaredLabels = {
+    readonly manifest: string;
+    readonly labels: readonly string[];
+};
+export declare const developerLabels: (manifests: readonly string[]) => Promise<readonly DeclaredLabels[]>;
+export declare const workspaceManifests: (root: string) => Promise<readonly string[]>;

package/adapter/hostModules.js

@@ -0,0 +1,2 @@
+// @bun
+import{readdir as g,readFile as l}from"fs/promises";import{dirname as m,join as s}from"path";import{Schema as t}from"effect";var d=t.Struct({host:t.optional(t.Array(t.String)),build:t.optional(t.Literal("developer")),labels:t.optional(t.Array(t.NonEmptyString))}),f=t.Struct({name:t.String,tagma:t.optional(d)}),k=t.decodeUnknownSync(t.fromJsonString(f)),u=t.decodeUnknownSync(t.Struct({tagma:t.optional(d)})),v=(n)=>n.flatMap((o)=>{let e=k(o);return(e.tagma?.host??[]).map((a)=>a.startsWith("./")?`${e.name}${a.slice(1)}`:a)}).sort(),i=(n)=>{if(n.code==="ENOENT"||n.code==="ENOTDIR")return null;throw n},S=["module.json","package.json"],h=async(n)=>{for(let o of S){let e=s(n,o),a=await l(e,"utf8").catch(i);if(a===null)continue;let r=JSON.parse(a);if(u({tagma:r.tagma}).tagma?.build==="developer")return{manifest:e}}return null},w=()=>{let n=new Map,o=(e)=>{let a=n.get(e);if(a!==void 0)return a;let r=h(e).then((c)=>{if(c!==null)return c;let p=m(e);return p===e?null:o(p)});return n.set(e,r),r};return(e)=>o(m(e))},M=async(n)=>{let o=[];for(let e of n){let a=await l(e,"utf8").catch(i);if(a===null)continue;let r=u({tagma:JSON.parse(a).tagma}).tagma;if(r?.build==="developer"&&r.labels!==void 0)o.push({manifest:e,labels:r.labels})}return o},D=async(n)=>{let o=s(n,"packages"),e=await g(o);return(await Promise.all(e.map((r)=>l(s(o,r,"package.json"),"utf8").catch(i)))).filter((r)=>r!==null)};export{M as developerLabels,w as developerMarks,v as hostSpecifiers,d as tagmaSection,D as workspaceManifests};

package/adapter/loader.d.ts

@@ -0,0 +1,10 @@
+/// <reference path="../types/node/index.d.ts" />
+/// <reference path="../host.d.ts" />
+import type { ProvidersDefinition } from "@runlith/tagma/plugin";
+export type HostModule = () => Promise<object>;
+export type HostModules = Readonly<Record<string, HostModule>>;
+export type ImportedProviders = ProvidersDefinition & {
+    readonly id: string;
+    readonly version: string;
+};
+export declare const importProviders: (directory: string, host: HostModules, argv?: readonly string[]) => Promise<ImportedProviders>;

package/adapter/loader.js

@@ -0,0 +1,2 @@
+// @bun
+import{readFile as f,realpath as m}from"fs/promises";import{join as l}from"path";import{Schema as i}from"effect";var a="tagma-plugin.json";var w=i.Struct({id:i.String,version:i.String,providers:i.optional(i.Struct({entry:i.String}))}),h=i.decodeUnknownSync(i.fromJsonString(w)),y,v=(t)=>y??=(async()=>{let r=[];for(let[n,e]of Object.entries(t))r.push([n,await e().then((o)=>({exports:o}),(o)=>({unloadable:o}))]);Bun.plugin({name:"adapter-host",setup(n){for(let[e,o]of r)n.module(e,()=>{if("unloadable"in o)throw o.unloadable;return{exports:{...o.exports},loader:"object"}})}})})(),g=(t,r)=>{if(typeof t!=="object"||t===null)throw Error(`${r} exports no provider part as its default: write export default defineProviders({ models, speech })`);let{models:n,speech:e}=t;if(n!==void 0&&typeof n!=="function")throw Error(`${r}: models is not an adapter: make it with defineAdapter from @runlith/tagma/adapter/provider`);if(e!==void 0&&!Array.isArray(e))throw Error(`${r}: speech is not a list of speech providers`);if(n===void 0&&e===void 0)throw Error(`${r} declares neither models nor speech`);return t},x=async(t,r,n=process.execArgv)=>{if(!n.includes("--no-install"))throw Error("the server runs without --no-install, so an import outside the host modules would install a second copy instead of failing; start it with bun --no-install");let e=await m(t),o=l(e,a),{id:p,version:u,providers:s}=h(await f(o,"utf8"));if(s===void 0)throw Error(`${o} declares no provider part`);let d=l(e,s.entry);await v(r);let c=await import(d);return{id:p,version:u,...g(c.default,d)}};export{x as importProviders};