code-yeongyu/oh-my-openagent / packages/omo-senpi/skills/omo-relay
omo-relay
VerifiedWorks on the account's other devices through omo's built-in relay from a js eval cell: run a command or a long job on another machine, read, write, edit or search its files, copy a directory tree to or from it, and run one operation on every machine, on chosen machines or on several threads at once with one outcome per target. Use when the user names another device, machine, host or computer of the account, asks for something on every machine or on all or several threads at once, or wants a fan-out or a remote command or file.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
| references/errors.md | markdown | 1.4 KB |
| references/machines.md | markdown | 3.1 KB |
| references/parallel.md | markdown | 3.1 KB |
| scripts/sdk/bind-eval.test.ts | script | 2.7 KB |
| scripts/sdk/bind-eval.ts | script | 5.7 KB |
| scripts/sdk/conformance.test.ts | script | 654 B |
| scripts/sdk/index.ts | script | 454 B |
| scripts/sdk/machines.test.ts | script | 5.4 KB |
| scripts/sdk/machines.ts | script | 5.2 KB |
| scripts/sdk/outcome.ts | script | 3.3 KB |
| scripts/sdk/ports.ts | script | 2.9 KB |
| scripts/sdk/threads.test.ts | script | 4.1 KB |
| scripts/sdk/threads.ts | script | 3.3 KB |
| scripts/sdk/tsconfig.json | config | 522 B |
| scripts/sdk/write-nothing.test.ts | script | 2.9 KB |
scripts/sdk/threads.test.ts
View on GitHubimport { describe, expect, test } from "bun:test"
import { onEveryThread, onThreads, readThreads, sendToThreads, ThreadListError } from "./index.ts"
import type { PortAnswer, ThreadPort, ThreadReadValue, ThreadSendValue } from "./ports.ts"
function fakeThreads(overrides: Partial<ThreadPort> = {}): ThreadPort & { readonly sent: string[] } {
const sent: string[] = []
return {
sent,
list: async () => ({
kind: "ok",
threads: [
{ thread: "t-1", name: "one" },
{ thread: "t-2", name: "two", machine: "device-b" },
],
}),
read: async (thread): Promise<PortAnswer<ThreadReadValue>> => ({
kind: "ok",
thread,
items: [{ text: `pong from ${thread}` }],
}),
send: async (thread, message): Promise<PortAnswer<ThreadSendValue>> => {
sent.push(`${thread}:${message}`)
if (thread === "t-missing")
return {
kind: "error",
error: { code: "not_found", message: "no such thread", next_action: "call thread_list" },
}
return { kind: "ok", thread }
},
...overrides,
}
}
describe("sendToThreads", () => {
test("#given a target whose send answers an error #when sent #then it is rejected with that error and the others deliver", async () => {
// given
const threads = fakeThreads()
// when
const batch = await sendToThreads(threads, ["t-1", "t-missing", "t-2"], "status", { all_scope: true })
// then
expect(batch.outcomes.map((outcome) => outcome.kind)).toEqual(["fulfilled", "rejected", "fulfilled"])
expect(batch.rejected[0]?.error).toEqual({
code: "not_found",
message: "no such thread",
next_action: "call thread_list",
})
expect(threads.sent).toEqual(["t-1:status", "t-missing:status", "t-2:status"])
})
})
describe("onThreads", () => {
test("#given a callback that throws for one thread #when run with a concurrency cap #then that thread is rejected and order holds", async () => {
// given
let inFlight = 0
let peak = 0
const op = async (thread: string): Promise<PortAnswer<{ readonly thread: string }>> => {
inFlight += 1
peak = Math.max(peak, inFlight)
await Promise.resolve()
inFlight -= 1
if (thread === "b") throw new TypeError("bad callback")
return { kind: "ok", thread }
}
// when
const batch = await onThreads(["a", "b", "c", "d"], op, { concurrency: 2 })
// then
expect(batch.outcomes.map((outcome) => [outcome.target, outcome.kind])).toEqual([
["a", "fulfilled"],
["b", "rejected"],
["c", "fulfilled"],
["d", "fulfilled"],
])
expect(batch.rejected[0]?.error.code).toBe("callback_failed")
expect(peak).toBe(2)
})
})
describe("readThreads", () => {
test("#given two threads #when read #then each answer is fulfilled with its items", async () => {
// when
const batch = await readThreads(fakeThreads(), ["t-1", "t-2"], { wait_ms: 1000 })
// then
expect(batch.ok).toBe(true)
expect(batch.fulfilled.map((outcome) => outcome.value.items)).toEqual([
[{ text: "pong from t-1" }],
[{ text: "pong from t-2" }],
])
})
})
describe("onEveryThread", () => {
test("#given a listed account #when run #then the op runs once per row with the row as target", async () => {
// when
const batch = await onEveryThread(fakeThreads(), async (row) => ({ kind: "ok", name: row.name }))
// then
expect(batch.fulfilled.map((outcome) => [outcome.target.thread, outcome.value.name])).toEqual([
["t-1", "one"],
["t-2", "two"],
])
})
test("#given a list that fails #when run #then it rejects with the list's code and nothing runs", async () => {
// given
const threads = fakeThreads({
list: async () => ({
kind: "error",
error: { code: "host_unavailable", message: "down", next_action: "retry later" },
}),
})
let ran = 0
// when
const run = onEveryThread(threads, async () => {
ran += 1
return { kind: "ok" }
})
// then
await expect(run).rejects.toBeInstanceOf(ThreadListError)
expect(ran).toBe(0)
})
})
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |