Repository navigation
Jason 0.23.0
Jason 0.23.0: the runtime, the CLI and the plugin host, one self-contained executable per platform, built
at this version and released only after its tests passed.
What is new since 0.22.0
-
The Windows executable is signed. A release signs
jason.exewith Reply's certificate, issued to ReplyApp Inc.
through Azure Artifact Signing, and timestamps it under RFC 3161, so the signature stays valid after the certificate
expires. Before anything is published, the release verifies the copy unpacked from the archive, with
signtool verify /paand with Windows' own reading of the signature, and stops unless that signature is valid,
timestamped and made by a certificate whose name is exactlyReplyApp Inc.. You can read the same yourself:
Get-AuthenticodeSignatureon the unpacked executable saysValid, the subject of the certificate it was signed with
beginsCN=ReplyApp Inc., andsigntool verify /pa /v, where the Windows SDK is installed, accepts it and prints the
timestamp. SmartScreen's reputation for a new publisher builds over downloads, so in the first weeks of signed
releases a download may still show its dialog. The section on what is signed, below, gives each line to type. -
The macOS executable's one native library is signed as well, and the executable carries two entitlements fewer.
libe_sqlite3.dylib, which the executable unpacks under~/.net/jason/the first time it runs, is signed with the
same Developer ID as the executable and timestamped before it is bundled. So the executable keeps the hardened
runtime's library validation, which loads only a library signed by Apple or by the executable's own team, and it
ignoresDYLD_environment variables: the only entitlements left,com.apple.security.cs.allow-jitand
com.apple.security.cs.allow-unsigned-executable-memory, let the .NET runtime compile code as it runs. As in 0.22.0,
the executable is notarized, and before anything is published the release's macOS job hasspctlassess the
executable's signature and stops unless that signature is accepted from the sourceNotarized Developer ID; the same
job now also starts a copy carrying the quarantine flag a browser puts on a download, and its log says whether that
copy started. The Linux executable is not signed, and the checksum stays its provenance. -
Each operation says whether a provider block holds its work. Every operation document now states
dispatch.under_provider_block,waitsorruns. When a provider refuses an account, or one sending account under
it, Jason keeps the block, and the work of an operation that sayswaitswaits on it and goes back to the queue when
it clears; the work of one that saysrunsgoes through the open block, and ablockedanswer ends it. Seven of
the twenty-four operations wait: the five whose reach isact, which may reach a person (message.send,
social_invitation.send,conversation.reply,campaign.enrollandcampaign.activate), and beside them
campaign.pauseandoptout.record, which must each happen once. Every read and every other control runs, and among
themmessage.cancel: taking a send back no longer waits behind the block that holds the send, since the moment of
the send it takes back would pass while it waited, and a take-back the provider answersblockedends failed, so a
notification says it as a protective action that failed. A block's trial, the one held item let through to learn
whether the provider still refuses, now goes first to held work that reaches a person, then by priority, then by
age, and a control's answer never clears a block: only an act the provider takes shows that it accepts the account
again. The contracts state the
property once. -
The API matches a request's members by their exact spelling. A member is compared ordinally, at every depth of a
request:Nameis notname. At the top of a body, a name that differs from a member only in case is skipped like
any member the operation does not take, so acampaign.createthat carriesNamealone answersvalidation_failed,
sayingnameis required. Inside a free-form object, such as a context or a patch'sset, it is a key of its own
beside the one it resembles. Among a work item's arguments it is a name the operation's schema does not declare,
refused as before, and a context that carriesInputin place ofinputcarries no arguments at all. Until now
members were matched without regard to case. Nothing stored, returned or handed to a plugin reads differently, and a
client that spells members as the API publishes them is refused nothing new.
The Runtime API page says so. -
jason status --provider-cli <name>says whose PATH it read. It looks a bare name up on the PATH of the process
runningjason status, which is not necessarily the PATH the runtime started with, and whenever it read a PATH its
answer now ends, in the JSON body'sfactand in the--humanline alike: It read the CLI's PATH; the runtime's
PATH may differ, see the install page. A name given as a path reads no PATH and says nothing of one, except an npm
shim whosenode.exeis not beside it. The JSON's shape is unchanged.
The install page says how the runtime's PATH
differs. -
This release publishes the Reply plugin 0.14.3, which needs Jason 0.22.0 or newer and reply-cli 0.18.0 or newer.
It reads Reply's deferred LinkedIn sends as Reply will answer them: a cancel of a send Reply is sending now, which
Reply refuses at 409 once Reply times deferred LinkedIn sends itself and reply-cli names
direct_send.already_sending, endssend_not_pendingas a send that already went, where 0.14.1 ends it
provider_call_failed; until then Reply answers such a cancel as one of a send that went, which both end
send_not_pending. A LinkedIn message, InMail or voice message may name a Reply sending schedule, as an email may,
where 0.14.1 refused one withprovider_input_invalid: once Reply times deferred LinkedIn sends itself, it holds the
message for the schedule's next opening, and until then the package answerscapability_not_offeredand sends
nothing. A schedule Reply cannot time a send by, one it does not hold, one with no hours to send in, or one that
keeps the contact's own time zone where Reply holds none, endsprovider_call_failed, permanent, on one row for each
of reply-cli's three codes, an email and a LinkedIn message alike, where 0.14.1 had no row for an email's. A cancel
Reply could not confirm, of a send still queued or waiting for its schedule, which reply-cli names
direct_send.cancel_not_confirmed, isprovider_unavailable, transient, and repeated, as Reply asks; 0.14.1 ends it
provider_call_failedunder reply-cli 0.18.0. Its README says what Reply answers for a LinkedIn send it holds for a
moment ahead or a schedule and how one can end, and with its error table says three things more exactly:- A LinkedIn invitation or message Reply refuses over the account's allowance, a 429 under
directLinkedIn.dailyLimitReachedordirectLinkedIn.weeklyLimitReached, is the sending account's block,
provider_blockedwith the allowance underlimit, whether or not Reply names the send in the statefailed
beside it; a 429 under no such code staysrate_limited. route_not_offeredsays reply-cli passes Reply's bare 404 through on every command but the ones that read every
404 as a thing not found, and names those, where 0.14.1 listed the commands that pass it through and left out most
of them,inbox list,inbox changes, the InMail and the voice message among them.- Reply answers an email timed by a sending schedule in one of two ways: queued, with its moment, where the schedule
is open now or opens within ten minutes, or waiting for the schedule, with only an estimate of the moment, where it
opens later. Both areaccepted, can still be cancelled, and carry noaccepted_for: the estimate, which
reply-cli 0.18.0 passes on asestimated_send_at, is never read as the moment Reply holds the send for.
The Reply plugin's page says each.
- A LinkedIn invitation or message Reply refuses over the account's allowance, a 429 under
-
For plugin authors.
dispatch.under_provider_blockis required on every operation document, with no default,
and a document whosereachisactthat saysrunsis refused when the catalog loads; every fixture that records a
blockedanswer now says whether the operation's work isheld. An attempt's provenance, asworkitem.getanswers
it, carriesinput_digest, a field added beside the others. The plugin
guide listspackage_unreadablebeside the
manifest's other problem codes: the load raises it whenplugin.yamlor the package cannot be read.
Fixed since 0.22.0
- A person's text no longer acts on the terminal of whoever reads a
--humanview. A name, a description, a
reason, a provider's message or a field value holding an escape sequence, a backspace, a line break or another
character that changes how a line reads is shown as U+FFFD in every human view: in every table, on every labelled
line, and in the lines a view writes around such text. Until now only the approval and thread views marked them. The
left-to-right, right-to-left and Arabic letter marks (U+200E, U+200F and U+061C) are printed as they came, as the
joiners and the soft hyphen already were, so text that mixes Arabic or Hebrew with Latin reads in order; the
overrides, embeddings and isolates stay marked. A question's later lines sit indented under its first, so a line of
the question cannot pass for the view's ownStatus:line. The JSON output is unchanged: the serializer already
escapes such characters. - On a Windows console with an OEM code page, a glyph the code page writes as a control byte no longer reaches the
terminal as one. Page 437 writes the right arrow as 0x1A, the left arrow as ESC and the eighth note as CR. The CLI
now writes a character outside ASCII that the console's encoding would write as a byte below 0x20, or as 0x7F, as
U+FFFD, and leaves every other character as it came. It does not change the console's code page, and under UTF-8
nothing changes. - A repeat after a lost answer is made only with the request that may already have reached the person. Where a
send's answer was lost and its plugin settles it by the work item's key, the claim repeated it under the same
package, account and arguments even where what Jason would send had changed since. It now also compares the whole
input composed for the plugin, by theinput_digesteach attempt's provenance records at its claim: the arguments,
the send, the person with the fields the operation projects, the address or profile the send consumes, the pins, the
campaign with its name and pins, and the work item's key, leaving out only the campaign's status, so a pause and a
resume change nothing. A person whose address, field or pin changed since, or a campaign renamed or pinned since,
refuses the repeat withprovider_answer_lost, final, as a changed argument already did. A pin the compared
attempt, or a later attempt of the same item, learned from the provider is left out before the comparison, since it
is the provider's own answer to that request. The digest names the input and carries none of it, no address
included. --humanlists a context that holds two keys differing only in case. A context holdingregionandRegionis
listed as two keys; before, the CLI exited 1 after the runtime had answered 200.
Upgrading from 0.22.0
- The executable:
jason update apply, or run the install line again. Installed with Homebrew, it is the three
linesjason update applyprints instead:jason runtime stop,brew upgrade jason,jason runtime start. The
install line and Homebrew place the executable alone, so after either,jason skills update,jason ui install
andjason plugin install reply --replacefollow. - The Reply plugin: with the package 0.22.0 published installed as it came, 0.14.1,
jason update applyreplaces
it with 0.14.3 and keeps the package it replaced under the data directory'supdate/previous/plugins/reply. A
package edited on this machine is left as it is, and so is the package under the install line and Homebrew:
jason plugin install reply --replaceswaps it for 0.14.3. 0.14.1 keeps working under 0.23.0 until it is replaced;
until then, once Reply times deferred LinkedIn sends itself, a cancel of a send Reply is sending ends
provider_call_failed. - reply-cli 0.18.0 or newer: the Reply plugin 0.14.3 asks for it, since 0.18.0 is the release that names a cancel
of a send Reply is sending, a cancel Reply could not confirm and a sending schedule that cannot time a send each by a
code of its own, and reads and cancels a LinkedIn send Reply holds for later by the reference Reply calls it by,
linkedin-scheduled-<n>. Under reply-cli 0.17.2 or older the plugin isunavailablewith
executable_incompatibleonce 0.14.3 is installed, so work routed to it fails
at the claim withplugin_unavailableand runs nothing. Update it withnpm install -g reply-cli, then
jason plugin reload. - The data directory: this release adds no database migration. Your projects, campaigns, work items and chronicle
stay as they were. - A take-back held by a block: a take-back that 0.22.0 parked behind a block stays parked after the upgrade until
that block clears. - A send whose answer 0.22.0 lost: an attempt recorded by 0.22.0 carries no
input_digest, so its repeat is
compared by its arguments only, as before; every attempt claimed by 0.23.0 is compared whole. - What reads or is refused differently:
campaign.createandcampaign.updaterefuse a campaign name holding a control character, andcontact.create,
contact.updateand each row ofcampaign.add_contactssuch afirst_nameorlast_name:validation_failed
with the detailinvalidon the field, the code and the shape the API already gives a value it refuses. A name
stored before is kept, and the human views show it marked.- Request members are matched by their exact spelling, a tightening: a member spelled in another case is no longer
read as the member it resembles. - A control's success under an open provider block, a held
campaign.pauselet through as the block's trial
included, leaves the block open; in 0.22.0 a held control's success, a pause's among them, cleared it. Only an
act the provider takes clears a block now, or a person withblock.clear.
- Skills: the update redeploys them wherever a deployment was recorded; after the install line or
brew upgrade jason, runjason skills update. The campaign manager and the troubleshooting skill say which held
work a block's trial lets through: acts first, and where none can run, one held control.
From 0.19.x to 0.21.x the update is one apply as well, and what the notes of 0.22.0 say of upgrading from 0.21.0
applies too, among it reply-cli 0.17.2 and the one migration 0.22.0 added. From 0.18.x or earlier, Jason's own
installation updates through 0.19.0: jason update apply --version 0.19.0, then jason update apply; from a build
older than 0.18.0, the first of the two can stop at started, as the first known issue below says.
Known issues
On a build older than 0.18.0, the update through 0.19.0 can stop at started, saying that a library failed to load.
That update is still performed by the older build, and it happens when the two builds carry different .NET patches.
Type jason update apply again: it runs 0.19.0, which finishes the update, and one more jason update apply then
takes the newest release. From 0.18.x this does not happen: 0.19.0 is built on the same .NET patch as 0.18.0.
Reply's routes behind 0.22.0's send features - a send's moment and its sending schedule, reading and cancelling a send
by its reference, and the inbox change feed - reach Reply's accounts on Reply's own schedule. Until an account's Reply
has a route, the Reply package answers capability_not_offered for that operation or argument, and the account's
replies are read thread by thread in place of the feed, as its README says; nothing in Jason needs updating when the
route arrives.
Through Reply, Jason sees only a contact's first reply. Reply marks a contact who replied as finished and stops
detecting that contact's later replies, so a later reply from the same contact never reaches Jason.
A send or an invitation through Reply carries no sending time in its own result: sent_at is null, because Reply's
answer to a LinkedIn send gives a local time marked as UTC and its answer to an email gives none. message.status
reports when a send went, and a message's own moment is read from its thread, where it is true UTC.
Through Reply, a sending schedule times a LinkedIn message only once the account's Reply times deferred LinkedIn sends
itself. Until then the Reply package answers a LinkedIn message that names one capability_not_offered, and nothing is
sent, whether the account's Reply has no direct sends yet or has them without a schedule on LinkedIn.
The approval preview shows a send's send_after and not the provider object beside the arguments, so a send that also
names a sending schedule goes at the schedule's first opening at or after that moment, which may be later than the
moment the approver read.
A template held for a later moment, or queued by Reply behind the account's other sends, is filled in when it goes: a
name Reply cannot fill then fails the send after a person approved it, which message.status reads as failed with
Reply's reason.
Reply converts a LinkedIn text from HTML to text after filling it in, so markup in a LinkedIn message or InMail, a
final text or a template, does not reach the person as written; what Reply makes of a < that starts a tag there is
not known yet, and the Reply package does not refuse one on LinkedIn as it does on email.
Reply does not consult its blacklist when it takes a LinkedIn direct send, and does when it makes it: a send to a
person its blacklist holds is accepted, and fails when Reply makes it, which message.status reads as failed with
Reply's reason. Jason's own do-not-contact register is checked at the claim as before; record such a stop there with
jason suppression add as well, so the send is refused before it is made.
Through Reply, schedule.list does not say which campaign runs on which schedule: campaign.get names no schedule,
so which one a campaign sends on is read at Reply.
Through Reply, a reply on a thread, conversation.reply, is not held to the rule on a < that starts a tag yet, and
its text goes as written; whether Reply cuts a reply as it cuts a direct email has not been seen, so write an address
in a reply without its angle brackets.
Assets
| File | For |
|---|---|
jason-win-x64.zip |
Windows on x64 |
jason-linux-x64.tar.gz |
Linux on x64 |
jason-osx-arm64.tar.gz |
macOS on Apple silicon |
manifest.json |
what a running Jason reads to learn that this release exists |
checksums.txt |
the SHA-256 of each archive and of the two packages, in sha256sum format |
install.sh |
macOS and Linux: the install script this release was published with |
install.ps1 |
Windows: the install script this release was published with |
jason-plugin-reply.zip |
the Reply plugin's package: the files of plugins/reply at v0.23.0, which jason plugin install reply places in ~/.jason/plugins/reply |
jason-ui.zip |
the browser UI's package: ui/ built at v0.23.0, which jason ui install places as the default UI |
Each archive holds the executable, LICENSE (the runtime's licence; the repository's MIT does not cover the
runtime) and THIRD-PARTY-NOTICES, nothing else. The Reply plugin's package is installed by
jason plugin install reply, which places it in ~/.jason/plugins/reply once it matches its line in
checksums.txt and the manifest's content digest; step 3 of docs/golden-path.md runs it. The UI's package is
placed by jason ui install, which the install guide runs and jason update apply runs at its end.
On Linux the executable needs the ICU library (libicu), which desktop distributions carry and minimal
images may not; the install script stops, with the runtime's own message, rather than install a program that does
not start.
Installing
One line, on macOS and Linux:
curl -fsSL https://jasonharness.ai/releases/latest/download/install.sh | shand on Windows, in PowerShell:
irm https://jasonharness.ai/releases/latest/download/install.ps1 | iexBy installing Jason you accept the Jason Runtime Licence:
https://github.com/reply-team/jason-ai/blob/v0.23.0/LICENSE-RUNTIME.md. If you do not accept it, do not
install Jason.
Both find this machine's archive, check it against checksums.txt before unpacking, and put jason on the
PATH — in ~/.local/bin, or %LOCALAPPDATA%\Programs\jason — with its licence and the third-party notices
beside it, as jason-LICENSE and jason-THIRD-PARTY-NOTICES. Running the line again over an installed Jason of
the same version changes nothing and says so, unless a licence file is missing beside the executable, which it
then writes. Two options, for a script that must be told:
curl -fsSL https://jasonharness.ai/releases/download/v0.23.0/install.sh | sh -s -- --version 0.23.0 --no-modify-path& ([scriptblock]::Create((irm https://jasonharness.ai/releases/download/v0.23.0/install.ps1))) -Version 0.23.0 -NoModifyPathUpgrading from 0.1.0
If this machine ran 0.1.0 with autostart enabled, run jason runtime autostart enable or disable once from an
ordinary prompt — if that answers Access is denied, follow its message first — then jason runtime stop once, then
jason runtime start (or sign in again, with autostart enabled). 0.1.0's logon task started a runtime that outlives a
sign-out and holds the data directory; until it stops, the runtime this version starts at sign-in finds the directory
taken and exits.
Checking a download by hand
sha256sum --check --ignore-missing checksums.txtOn Windows, compare Get-FileHash of the archive with its line in checksums.txt.
If you then put the executable in place by hand, keep LICENSE and THIRD-PARTY-NOTICES beside it, named
jason-LICENSE and jason-THIRD-PARTY-NOTICES.
What is signed
The macOS executable is signed with Reply's Developer ID and notarized by Apple. Before anything is published, the
release's macOS job has spctl assess the executable's signature and stops unless that signature is accepted from the
source Notarized Developer ID; the same job starts a copy carrying the quarantine flag a browser puts on a download,
and its log says whether that copy started and opened its database. The ticket is not stapled to the file, which a
bare executable has no place for; for a file without a stapled ticket, Apple's documentation says Gatekeeper finds the
ticket online. The quarantine flag is put there by the browser that downloaded the file, not by curl, so the
one-liner's download has none and install.sh clears nothing; an archive fetched with a browser and unpacked by hand
keeps the flag.
Who signed it is yours to read: codesign -dv --verbose=2 on the unpacked executable prints an
Authority=Developer ID Application: line naming Reply and its team id in parentheses, the same id the
TeamIdentifier= line gives. spctl accepts the signature of any notarized Developer ID from the source
Notarized Developer ID, so it is that name and that team id, not the acceptance, that say the executable is Reply's.
The one native library the executable carries, libe_sqlite3.dylib, is signed with the same Developer ID and
timestamped before it is bundled; the executable unpacks it under ~/.net/jason/ the first time it runs, and
codesign -dv --verbose=2 on it prints the same Authority= and TeamIdentifier= lines. So the executable keeps the
hardened runtime's library validation, which loads only a library signed by Apple or by the executable's own team, and
it ignores DYLD_ environment variables: the only entitlements it carries, com.apple.security.cs.allow-jit and
com.apple.security.cs.allow-unsigned-executable-memory, let the .NET runtime compile code as it runs.
The Windows executable is signed with Reply's certificate through Azure Artifact Signing, and timestamped under
RFC 3161, so the signature stays valid after the certificate expires. Who signed it is yours to read, in Windows
PowerShell or PowerShell alike: Get-AuthenticodeSignature on the unpacked executable says Valid, and, run where it
was unpacked, (Get-AuthenticodeSignature .\jason.exe).SignerCertificate.Subject prints the subject the certificate
is issued to, which begins CN=ReplyApp Inc.; signtool verify /pa /v, where the Windows SDK is installed, accepts it
and prints the timestamp. An archive a browser downloaded carries the mark of the web, and
SmartScreen looks at the executable unpacked from it the first time it runs. SmartScreen's reputation for a new
publisher builds over downloads, so in the first weeks of signed releases a download may still show its dialog;
install.ps1 clears that mark from what it unpacks.
The Linux executable is not signed, and nothing else a release carries is either.
Both scripts check the archive against checksums.txt before unpacking. On Linux that check is the only provenance
there is; on macOS and Windows the signature says who built the executable as well.