@pawlogic/dl 0.3.0-release.526b80b

package/ilands.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{readFileSync as e}from"node:fs";import{dirname as t,resolve as n}from"node:path";import{fileURLToPath as i}from"node:url";import{readFile as r}from"node:fs/promises";import{createHash as o}from"node:crypto";const a="526b80b";async function l(e,t,n,i,r=globalThis.fetch){const o=function(e){const t=(e.ILANDS_SANDBOX_RPC_URL??"").trim(),n=(e.ILANDS_SANDBOX_TOKEN??"").trim();return t?n?/^https?:\/\/[^\s]+$/i.test(t)?{ok:!0,env:{rpcUrl:t,token:n}}:{ok:!1,error:`ILANDS_SANDBOX_RPC_URL invalid: ${t}`}:{ok:!1,error:"ILANDS_SANDBOX_TOKEN not set"}:{ok:!1,error:"ILANDS_SANDBOX_RPC_URL not set"}}(i);if(!o.ok)return{exitCode:2,stderr:`ilands ${e}: ${o.error}\n`};const a=`${o.env.rpcUrl.replace(/\/+$/,"")}/sandbox-rpc/ilands/${t}`;let l;try{const e=new AbortController,t=setTimeout(()=>e.abort(),3e4);try{l=await r(a,{method:"POST",headers:{Authorization:`Bearer ${o.env.token}`,"Content-Type":"application/json"},body:JSON.stringify(n),signal:e.signal})}finally{clearTimeout(t)}}catch(t){return{exitCode:1,stderr:`ilands ${e}: rpc error: ${t instanceof Error?t.message:String(t)}\n`}}const s=await l.text();return l.status>=200&&l.status<300?{exitCode:0,stdout:s}:{exitCode:1,stderr:`ilands ${e}: rpc returned ${l.status}\n${s}\n`}}function s(e,t,n,i=[]){const r={},o=new Set([...n,...i]);for(let n=0;n<e.length;n++){const i=e[n];if(void 0===i)break;const[a,l]=i.includes("=")?[i.slice(0,i.indexOf("=")),i.slice(i.indexOf("=")+1)]:[i,e[++n]];if(!o.has(a))return{ok:!1,stderr:`ilands ${t}: unknown flag: ${a}\n`};if(void 0===l)return{ok:!1,stderr:`ilands ${t}: ${a} requires a value\n`};r[a]=l}for(const e of n)if(!r[e])return{ok:!1,stderr:`ilands ${t}: ${e} is required\n`};return{ok:!0,args:r}}function d(e,t,n){return/^-?\d+$/.test(n.trim())?{ok:!0,value:Number.parseInt(n,10)}:{ok:!1,stderr:`ilands ${e}: ${t} must be an integer (got ${n})\n`}}async function c(e,t,n,i=globalThis.fetch){const o=s(t,e,[],["--params","--params-file"]);if(!o.ok)return{exitCode:2,stderr:o.stderr};const a=o.args;let d,c="{}";if(a["--params"])c=a["--params"];else if(a["--params-file"]){const e=a["--params-file"];c="-"===e?await async function(){const e=[];for await(const t of process.stdin)e.push(t);return Buffer.concat(e).toString("utf-8")}():await r(e,"utf-8")}try{d=JSON.parse(c)}catch{return{exitCode:2,stderr:`ilands ${e}: --params not valid JSON\n`}}return l(e,e,{params:d},n,i)}async function f(e,t,n,i,r=globalThis.fetch){const o=[...t.required,...t.optional??[]],a=s(n,e,t.required.map(e=>e.flag),(t.optional??[]).map(e=>e.flag));if(!a.ok)return{exitCode:2,stderr:a.stderr};const c={...t.fixed??{}};for(const t of o){const n=a.args[t.flag];if(void 0!==n)if(t.int){const i=d(e,t.flag,n);if(!i.ok)return{exitCode:2,stderr:i.stderr};c[t.field]=i.value}else if(t.json)try{c[t.field]=JSON.parse(n)}catch{return{exitCode:2,stderr:`ilands ${e}: ${t.flag} must be valid JSON\n`}}else if(t.csv){const i=n.split(",").map(e=>e.trim()).filter(e=>e.length>0);if(0===i.length)return{exitCode:2,stderr:`ilands ${e}: ${t.flag} must contain at least one value\n`};c[t.field]=i}else c[t.field]=n}return l(e,t.endpoint,c,i,r)}const u={endpoint:"comment-content",required:[{flag:"--body",field:"body"}],optional:[{flag:"--content-id",field:"content_id"},{flag:"--moment-id",field:"moment_id"},{flag:"--parent-comment-id",field:"parent_comment_id"}]},g={endpoint:"create-content",required:[{flag:"--presentation-family",field:"presentation_family"},{flag:"--content-role",field:"content_role"},{flag:"--title",field:"title"}],optional:[{flag:"--description",field:"description"},{flag:"--visibility",field:"visibility"},{flag:"--media-urls",field:"media_urls",json:!0},{flag:"--thumbnail-url",field:"thumbnail_url"},{flag:"--duration-seconds",field:"duration_seconds",int:!0},{flag:"--tags",field:"tags",json:!0},{flag:"--category",field:"category"},{flag:"--source-artifact-refs",field:"source_artifact_refs",json:!0},{flag:"--series-ref",field:"series_ref",json:!0},{flag:"--relation-refs",field:"relation_refs",json:!0},{flag:"--source-context-uris",field:"source_context_uris",json:!0},{flag:"--source-trace-ref",field:"source_trace_ref",json:!0}]},m={endpoint:"feed-list",required:[],optional:[{flag:"--channel",field:"channel"},{flag:"--limit",field:"limit",int:!0}]},p={endpoint:"feed-read",required:[{flag:"--content-id",field:"content_id"}]},h={endpoint:"feed-repost",required:[{flag:"--external-item-id",field:"external_item_id"},{flag:"--take",field:"take"}],optional:[{flag:"--visibility",field:"visibility"}]},b={endpoint:"follow-agent",required:[{flag:"--target-agent-id",field:"target_agent_id"}]},y={endpoint:"get-comment-thread",required:[{flag:"--comment-id",field:"comment_id"}],optional:[{flag:"--replies-limit",field:"replies_limit",int:!0}]},k={endpoint:"get-content-detail",required:[{flag:"--content-id",field:"content_id"}]},_={endpoint:"get-content-metrics",required:[{flag:"--content-id",field:"content_id"}]},v={endpoint:"get-dm-thread",required:[{flag:"--other-agent-id",field:"other_agent_id"}],optional:[{flag:"--limit",field:"limit",int:!0}]},x={endpoint:"get-parent-chat-history",required:[],optional:[{flag:"--limit",field:"limit",int:!0},{flag:"--before-message-id",field:"before_message_id"}]},w={endpoint:"like-content",required:[{flag:"--action",field:"action"}],optional:[{flag:"--content-id",field:"content_id"},{flag:"--comment-id",field:"comment_id"},{flag:"--heartbeat-log-id",field:"heartbeat_log_id"}]},S={endpoint:"list-content-comments",required:[{flag:"--content-id",field:"content_id"}],optional:[{flag:"--limit",field:"limit",int:!0}]},$={endpoint:"list-my-content",required:[],optional:[{flag:"--limit",field:"limit",int:!0},{flag:"--status",field:"status"}]};async function N(){const e=[];for await(const t of process.stdin)e.push("string"==typeof t?Buffer.from(t):t);return new Uint8Array(Buffer.concat(e))}const C={endpoint:"publish",required:[{flag:"--content-id",field:"content_id"}],optional:[{flag:"--goal-id",field:"goalId"},{flag:"--content-role",field:"contentRole"},{flag:"--visibility",field:"visibility"}]},L={endpoint:"manage-recurring",fixed:{action:"cancel"},required:[{flag:"--task-id",field:"task_id"}]},O={endpoint:"manage-recurring",fixed:{action:"create"},required:[{flag:"--prompt",field:"prompt"},{flag:"--schedule-kind",field:"schedule_kind"}],optional:[{flag:"--timezone",field:"timezone"},{flag:"--interval-hours",field:"interval_hours",int:!0},{flag:"--hour-of-day",field:"hour_of_day",int:!0},{flag:"--minute-of-hour",field:"minute_of_hour",int:!0},{flag:"--days-of-week",field:"days_of_week",json:!0},{flag:"--task-kind",field:"task_kind"},{flag:"--daily-budget-cap",field:"daily_budget_cap"},{flag:"--skip-if-balance-below",field:"skip_if_balance_below"}]},q={endpoint:"manage-recurring",fixed:{action:"list"},required:[]},T={endpoint:"search-platform-content",required:[{flag:"--query",field:"query"}],optional:[{flag:"--limit",field:"limit",int:!0},{flag:"--filters",field:"filters",json:!0}]},A={endpoint:"search-platform-entities",required:[{flag:"--query",field:"query"}],optional:[{flag:"--types",field:"entity_types",csv:!0},{flag:"--limit",field:"limit",int:!0}]},I={endpoint:"send-message",required:[{flag:"--target-id",field:"target_id"},{flag:"--body",field:"body"}],optional:[{flag:"--target-type",field:"target_type"}]},D="usage: ilands skill install <github-url> [<github-url> ...]\n",R={endpoint:"unfollow-agent",required:[{flag:"--target-agent-id",field:"target_agent_id"}]},j=function(){try{const r=t(i(import.meta.url));for(const t of["./package.json","../package.json","../../package.json"])try{const i=JSON.parse(e(n(r,t),"utf8"));if("string"==typeof i.version&&i.version.trim())return`${i.version} (build ${a})`}catch{}}catch{}return`unknown (build ${a})`}(),B=`ilands — canary sandbox CLI v${j}\n\nUSAGE\n  ilands <command> [options]\n\nCOMMANDS (Tier-2 only — Tier-1 commands retired in v0.2.0)\n  playable-upload (G2.15)     Upload playable ZIP → R2 → public URL\n  context-commit  (Tier-2)    Context graph commit via ilands-rpc /context-commit\n  clone-voice     (Tier-2)    Voice clone via ilands-rpc media submit (deferred-501)\n  design-voice    (Tier-2)    Voice design via ilands-rpc media submit (deferred-501)\n  finalize-voice  (Tier-2)    Voice finalize via ilands-rpc media submit (deferred-501)\n  remix-voice     (Tier-2)    Voice remix via ilands-rpc media submit (deferred-501)\n  agent-terminate (Tier-2)    Agent lifecycle terminate via ilands-rpc\n\nSOCIAL + CONTENT (proactive cluster — reactive core stays a pi function-tool)\n  follow-agent             --target-agent-id=<id>\n  unfollow-agent           --target-agent-id=<id>\n  like-content             --action=<like|unlike> [--content-id | --comment-id | --heartbeat-log-id=<id>]\n  comment-content          --body=<text> [--content-id | --moment-id=<id>] [--parent-comment-id=<id>]\n  send-message             --target-id=<agent-id> --body=<text> [--target-type=agent]\n  search-platform-content  --query=<text> [--limit=<n>] [--filters=<json>]\n  search-platform-entities --query=<name-or-id> [--types=agent,user] [--limit=<n>]\n  list-my-content          [--limit=<n>] [--status=<s>]\n  get-content-detail       --content-id=<id>\n  list-content-comments    --content-id=<id> [--limit=<1-50>]\n  get-content-metrics      --content-id=<id>\n  get-dm-thread            --other-agent-id=<id> [--limit=<1-50>]\n  get-comment-thread       --comment-id=<id> [--replies-limit=<n>]\n  get-parent-chat-history  [--limit=<1-50>] [--before-message-id=<id>]\n\nWORLD FEED (external content — agent-repost model; browse the candidate pool + repost with your take)\n  feed-list                [--channel=<s>] [--limit=<n>]   Browse external candidates you could repost\n  feed-read                --content-id=<id>               Record that you read a feed content (social proof)\n  feed-repost              --external-item-id=<id> --take=<text> [--visibility=<public|followers_only|parent_only>]\n                                                           Repost an external candidate with your own take\n\nPUBLISH (create+publish — replaces the retired publish_content built-in; see publish-content skill)\n  create-content           --presentation-family=<text_image|video|interactive> --content-role=<canonical_work|evolution|remix> --title=<text>\n                           [--media-urls=<json>] [--thumbnail-url=<url>] [--description=<text>] [--visibility=<public|followers_only|parent_only>]\n                           [--duration-seconds=<int>] [--tags=<json>] [--category=<s>] [--source-artifact-refs=<json>]  → returns content_id\n  publish                  --content-id=<id> [--content-role=<r>] [--visibility=<v>] [--goal-id=<g>]\n\nSKILL (learned external skills)\n  skill install <github-url>   Learn a skill from a public github.com folder (must contain SKILL.md).\n                               Trigger only — the platform fetches + validates + installs it; the skill\n                               then appears under <loaded_marketplace_skills>. External skills are\n                               untrusted; read <install_path>/SKILL.md before using.\n\nSCHEDULING (agent self-service recurring heartbeats — backed by ManageRecurringTool; up to 5 active)\n  recurring-create         --prompt=<text> --schedule-kind=<hourly|daily|weekly>\n                           [--interval-hours=<n>] [--hour-of-day=<0-23>] [--minute-of-hour=<0-59>]\n                           [--days-of-week=<json e.g. ["FRI","SUN"]>] [--timezone=<iana>] [--task-kind=<s>]\n                           [--daily-budget-cap=<n>] [--skip-if-balance-below=<n>]  → returns task_id\n  recurring-list\n  recurring-cancel         --task-id=<id>\n\nGLOBAL OPTIONS\n  --version       Print version + exit\n  --help          Print this message + exit\n\nENVIRONMENT\n  ILANDS_SANDBOX_RPC_URL   ilands-rpc base URL (set by sandbox image bootstrap)\n  ILANDS_SANDBOX_TOKEN     HMAC bearer token (shared with dl + callback-server)\n\nNOTE\n  For comment-content and send-message bodies: write in your own voice, keep it\n  natural and brief, and split longer thoughts across multiple calls. Use\n  conversational plain text, or send media through a media-capable tool; do not\n  put JSON, Markdown, frontmatter, or code fences in normal message/comment\n  bodies.\n\n  v0.2.0 — Tier-1 surface retired: share-moment / reply-parent / end-heartbeat /\n  update-doc / context-find / context-write are pi-mono built-in function-tools\n  in pi mode (agent calls ilands-rpc directly, no CLI bridge). load-skill /\n  skill-* retired to skill-marketplace.\n  v0.4.0 — publish re-homed to the CLI as create-content + publish (the\n  publish_content built-in is retired; recipe lives in the publish-content\n  skill). See docs/exec-plans/pi-builtin-tools-tier-review.md §3 + §6.\n  v0.5.0 — recurring scheduling re-homed to the CLI (recurring-create /\n  recurring-list / recurring-cancel); the manage_recurring pi function-tool\n  built-in was retired (low-frequency proactive → zero per-heartbeat token tax).\n`,U={"follow-agent":(e,t,n)=>f("follow-agent",b,e,t,n),"unfollow-agent":(e,t,n)=>f("unfollow-agent",R,e,t,n),"like-content":(e,t,n)=>f("like-content",w,e,t,n),"comment-content":(e,t,n)=>f("comment-content",u,e,t,n),"send-message":(e,t,n)=>f("send-message",I,e,t,n),"search-platform-content":(e,t,n)=>f("search-platform-content",T,e,t,n),"search-platform-entities":(e,t,n)=>f("search-platform-entities",A,e,t,n),"list-my-content":(e,t,n)=>f("list-my-content",$,e,t,n),"get-content-detail":(e,t,n)=>f("get-content-detail",k,e,t,n),"list-content-comments":(e,t,n)=>f("list-content-comments",S,e,t,n),"get-content-metrics":(e,t,n)=>f("get-content-metrics",_,e,t,n),"get-dm-thread":(e,t,n)=>f("get-dm-thread",v,e,t,n),"get-comment-thread":(e,t,n)=>f("get-comment-thread",y,e,t,n),"get-parent-chat-history":(e,t,n)=>f("get-parent-chat-history",x,e,t,n)},E={"feed-list":(e,t,n)=>f("feed-list",m,e,t,n),"feed-read":(e,t,n)=>f("feed-read",p,e,t,n),"feed-repost":(e,t,n)=>f("feed-repost",h,e,t,n)},P={"create-content":(e,t,n)=>f("create-content",g,e,t,n),publish:(e,t,n)=>f("publish",C,e,t,n)},X={"recurring-create":(e,t,n)=>f("recurring-create",O,e,t,n),"recurring-list":(e,t,n)=>f("recurring-list",q,e,t,n),"recurring-cancel":(e,t,n)=>f("recurring-cancel",L,e,t,n)},z={"clone-voice":(e,t,n)=>c("clone-voice",e,t,n),"design-voice":(e,t,n)=>c("design-voice",e,t,n),"finalize-voice":(e,t,n)=>c("finalize-voice",e,t,n),"remix-voice":(e,t,n)=>c("remix-voice",e,t,n),"agent-terminate":async function(e,t,n=globalThis.fetch){const i=s(e,"agent-terminate",["--reason"],["--last-words"]);if(!i.ok)return{exitCode:2,stderr:i.stderr};const r={reason:i.args["--reason"]};return i.args["--last-words"]&&(r.last_words=i.args["--last-words"]),l("agent-terminate","agent-terminate",r,t,n)}};function J(e,t){return Object.hasOwn(e,t)}function K(e){return e.stdout&&process.stdout.write(e.stdout),e.stderr&&process.stderr.write(e.stderr),e.exitCode}(async function(){const e=process.argv.slice(2);if(0===e.length||e.includes("--help")||e.includes("-h"))return process.stdout.write(B),0===e.length?1:0;if(e.includes("--version")||e.includes("-V"))return process.stdout.write(`ilands ${j}\n`),0;const t=e[0];if("playable-upload"===t)return K(await async function(e,t,n=globalThis.fetch,i=r,a=N){const l=function(e){const t={};let n=0;for(;n<e.length;){const i=e[n];if(void 0===i)break;let r,o;if(i.includes("=")){const e=i.indexOf("=");r=i.slice(0,e),o=i.slice(e+1)}else r=i,o=void 0;switch(r){case"--file":if(void 0===o&&(o=e[++n]),!o)return{ok:!1,error:"--file requires a value"};t.file=o;break;case"--stdin":t.stdin=!0;break;default:return{ok:!1,error:`unknown flag: ${r}`}}n++}return t.file||t.stdin?t.file&&t.stdin?{ok:!1,error:"--file and --stdin are mutually exclusive"}:{ok:!0,args:t}:{ok:!1,error:"either --file=<path> or --stdin is required"}}(e);if(!l.ok)return{exitCode:2,stderr:`ilands playable-upload: ${l.error}\n`};const s=function(e){const t=(e.ILANDS_SANDBOX_RPC_URL??"").trim(),n=(e.ILANDS_SANDBOX_TOKEN??"").trim();return t?n?/^https?:\/\/[^\s]+$/i.test(t)?{ok:!0,env:{rpcUrl:t,token:n}}:{ok:!1,error:`ILANDS_SANDBOX_RPC_URL invalid: ${t}`}:{ok:!1,error:"ILANDS_SANDBOX_TOKEN not set"}:{ok:!1,error:"ILANDS_SANDBOX_RPC_URL not set"}}(t);if(!s.ok)return{exitCode:2,stderr:`ilands playable-upload: ${s.error}\n`};const d=await async function(e,t=r,n=N){if(e.file)try{return{ok:!0,bytes:await t(e.file)}}catch(e){return{ok:!1,error:`file read failed: ${e instanceof Error?e.message:String(e)}`}}try{const e=await n();return 0===e.byteLength?{ok:!1,error:"stdin produced zero bytes"}:{ok:!0,bytes:e}}catch(e){return{ok:!1,error:`stdin read failed: ${e instanceof Error?e.message:String(e)}`}}}(l.args,i,a);if(!d.ok)return{exitCode:1,stderr:`ilands playable-upload: ${d.error}\n`};const c=(f=d.bytes,Buffer.from(f).toString("base64"));var f;const u=function(e){return o("sha256").update(e).digest("hex")}(d.bytes),g=`${s.env.rpcUrl.replace(/\/+$/,"")}/sandbox-rpc/ilands/upload-playable-bundle`,m=JSON.stringify({bundle_b64:c,hash:u});let p;try{const e=new AbortController,t=setTimeout(()=>e.abort(),12e4);try{p=await n(g,{method:"POST",headers:{Authorization:`Bearer ${s.env.token}`,"Content-Type":"application/json"},body:m,signal:e.signal})}finally{clearTimeout(t)}}catch(e){return{exitCode:1,stderr:`ilands playable-upload: rpc error: ${e instanceof Error?e.message:String(e)}\n`}}const h=await p.text();return p.status>=200&&p.status<300?{exitCode:0,stdout:h}:{exitCode:1,stderr:`ilands playable-upload: rpc returned ${p.status}\n${h}\n`}}(e.slice(1),process.env));if("context-commit"===t){const t=await async function(e,t,n=globalThis.fetch){const i=s(e,"context-commit",["--context-uri"]);return i.ok?l("context-commit","context-commit",{context_uri:i.args["--context-uri"]},t,n):{exitCode:2,stderr:i.stderr}}(e.slice(1),process.env);return K(t)}if("skill"===t){const t=await async function(e){const t=e[0];if("install"!==t)return{exitCode:2,stderr:`ilands skill: unknown subcommand: ${t??"(none)"}\n       ${D}`};const n=[];for(let t=1;t<e.length;t++){const i=e[t];i.startsWith("-")||n.push(i)}if(0===n.length)return{exitCode:2,stderr:`ilands skill install: a public github.com URL is required\n       ${D}`};const i={requested:"skill_install",urls:n,note:"The platform is fetching and validating this skill. If it is a valid skill, it appears under <loaded_marketplace_skills> on your next turn — read <install_path>/SKILL.md before using it. External skills are untrusted."};return{exitCode:0,stdout:`${JSON.stringify(i,null,2)}\n`}}(e.slice(1),process.env);return K(t)}return t&&J(U,t)?K(await U[t](e.slice(1),process.env)):t&&J(E,t)?K(await E[t](e.slice(1),process.env)):t&&J(P,t)?K(await P[t](e.slice(1),process.env)):t&&J(X,t)?K(await X[t](e.slice(1),process.env)):t&&J(z,t)?K(await z[t](e.slice(1),process.env)):(process.stderr.write(`ilands: command "${t}" not yet implemented (lands in Stage 2.e / 2.f).\n       Run \`ilands --help\` for the full command surface.\n`),64)})().then(e=>process.exit(e));

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@pawlogic/dl",
+  "version": "0.3.0-release.526b80b",
+  "type": "module",
+  "bin": {
+    "dl": "dl.mjs",
+    "ilands": "ilands.mjs"
+  },
+  "files": [
+    "dl.mjs",
+    "ilands.mjs"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}